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Rust est un langage système moderne mettant l'accent sur la sécurité, la vélocité et la 
concurrence. Il y parvient en gérant la mémoire sans utiliser de ramasse-miettes(garbage 
collector). 

RBE est une collection d'exemples parfaitement exécutables qui illustre les différents 
concepts du langage Rust et ses bibliothèques standards. 

Pour en savoir plus à propos des exemples présentés, n'oubliez pas d'installer Rust 

sur votre machine et de visiter la documentation officielle. Pour les plus curieux, vous 
pouvez également consulter le code source du site. 
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1 - Hello World 


Voici le code source d'un traditionnel « Hello World ». 


1. // Ceci est un commentaire, et sera ignoré par le compilateur. 

2 . 

3. // Ceci est la fonction principale 

4 . fn main() { 

5. // Toutes les déclarations se trouvant dans le corps de la fonction 

6. // seront exécutées lorsque le binaire est exécuté. 

7. // Afficher du texte dans la console. 

8. println! ("Hello World!"); 

9. 1 


println! est une macro qui affiche du texte sur la console. 

Un binaire peut être généré en utilisant le compilateur Rust : rustc. 

$ rustc hello.rs 

rustc va produire un binaire nommé « hello » qui pourra être exécuté : 

$ ./hello 
Hello World! 


Activité 

Cliquez sur le bouton « Run » en début de section pour visualiser le résultat présenté. Ensuite, ajoutez une nouvelle 
ligne qui permettra de visualiser le résultat ci-dessous : 


Hello World! 

I'm a Rustacean! 


1-1 - Les commentaires 


N'importe quel programme a besoin de commentaires, c'est pour cela que Rust supporte différentes syntaxes : 
Les commentaires basiques ignorés par le compilateur : 

• // Les commentaires mono-lignes. ; 

• /* Les blocs de commentaires régis par leurs délimiteurs. */. 

Les commentaires dédiés à la documentation qui seront convertis au format HTML : 

• /// Génère de la documentation pour ce qui suit ce commentaire. ; 

• //! Génère la documentation pour un conteneur (e.g. un module) ; 

• /*! Permet de rédiger un bloc entier de documentation.*/. 


1-2 - Affichage formaté 


L'affichage est pris en charge par une série de macros déclarées dans le module std::fmt qui inclut : 

• format! : Construit la chaîne de caractères du texte à afficher ; 

• print! : Fait exactement la même chose que format!, mais le texte est affiché dans la console ; 

• println! : Fait exactement la même chose que print!, mais un retour à la ligne est ajouté. 
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Toutes formatent le texte de la même manière. 

Note : la validité du formatage (i.e. Si la chaîne de caractères que vous soumettez peut être formatée comme vous 
le désirez) est vérifiée au moment de la compilation. 


1. fn main(){ 

2. //En général, le marqueur '{}' sera automatiquement remplacé par 

3. // n'importe quel argument. Il sera transformé en chaîne de caractères. 

4. println!("{} jours", 31); 

5. 

6. // Sans suffixe, 31 est de type i32. Vous pouvez changer le type de 31 avec 

7. // un suffixe, (e.g. 31i64) 

8. 

9. // Différents modèles peuvent être utilisés. 

10. // Les marqueurs de position peuvent être utilisés. 

11. println! ( " { 0}, voici {1}. {1}, voici {0}", "Alice", "Bob"); 

12 . 

13. // Les marqueurs peuvent également être 

14. // nommés 

15. println !("{sujet} {verbe} {objet}", 

16. objet="le chien paresseux", 

17. sujet="Rapide, le renard", 

18. verbe="saute par-dessus"); 

19. 

20. // Un formatage spécial peut être spécifié après un 

21. println! ("{} personne sur {: b} sait lire le binaire, l'autre moité non.", 1, 2); 
22 . 

23. // Vous pouvez aligner vers la droite votre texte en spécifiant 

24. // la largeur (en espace) entre le côté gauche de la console 

25. // et votre chaîne. Cet exemple affichera: " 1", un "1" après 5 espaces. 

26. 

27. println! ( "{number:>width$}" , number=l, width=6); 

28. 

29. // Vous pouvez également remplacer les white spaces par des '0'. 

30. // Affiche: "000001" 

31. 

32. println! ("{number:>0width$}" , number=l, width=6); 

33. 

34. // Le nombre d'arguments utilisé est vérifié par le compilateur. 

35. // println!("Mon nom est {0}, {1} {0}", "Bond"); 

36. // FIXME A Ajoutez l'argument manquant: "James". 

37. 

38. // On créé une structure nommé 'Structure' contenant un entier de type '132'. 

39. #[allow(dead_code)] 

40. struct Structure(132); 

41. 

42. // Cependant, les types complexes tels que les structures demandent 

43. // une gestion de l'affichage plus complexe. Cela ne fonctionnera pas. 

44. // println!("Cette structure '{}' ne sera pas affichée...", Structure(3)); 

45. // FIXME A Commentez/Décommentez cette ligne pour voir le message d'erreur. 

46. } 


std::fmt contient plusieurs traits qui structurent l'affichage du texte. Les deux plus « importants » sont listés ci-dessous : 

1 fmt::Debug : Utilise le marqueur {:?}. Applique un formatage dédié au débogage. 

2 fmt::Display : Utilise le marqueur {}. Formate le texte de manière plus élégante, plus « user friendly ». 

Dans cet exemple, fmt::Display était utilisé parce que la bibliothèque standard fournit les implémentations pour ces 
types. Pour afficher du texte à partir de types complexes/personnalisés, d'autres étapes sont requises. 

Activité 

Réglez les deux problèmes dans le code ci-dessus (cf. FIXME) pour qu'il s'exécute sans erreurs. 

Ajoutez une macro println! qui affiche : « Pi est, à peu près, égal à 3,142 » en contrôlant le nombre affiché de chiffres 
après la virgule. Dans le cadre de l'exercice, vous utiliserez let pi = 3.141592 comme estimation de Pi (Note : vous 
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pourriez avoir besoin de consulter la documentation du module std::fmt pour configurer le nombre de décimaux à 
afficher). 

Voir aussi 

std::fmt, les macros, les structures, les traits. 


1-2-1 - Debug 


Tous les types qui utilisent le formatage des traits du module std::fmt doivent en posséder une implémentation pour 
être affichés. 

Les implémentations ne sont fournies automatiquement que pour les types supportés par la bibliothèque standard. 
Les autres devront l'implémenter « manuellement ». 

Pour le trait fmt::Debug, rien de plus simple. Tous les types peuvent hériter de son implémentation (i.e. la créer 
automatiquement, sans intervention de votre part). Ce n'est, en revanche, pas le cas pour le second trait : fmt::Display. 

1. // Cette structure ne peut être affichée par 'fmt::Debug', 

2. // ni par 'fmt:: Display'. 

3. struct UnPrintable(i32); 

4 . 

5. // L'attribut 'dérivé' créé automatiquement l'implémentation requise 

6. // pour permettre à cette structure d'être affichée avec 'fmt::Debug'. 

7. #[dérivé(Debug)] 

8. struct DebugPrintable(i32); 


Également, tous les types de la bibliothèque standard peuvent être automatiquement affichés avec le marqueur {:?} : 


1. // On fait hériter l'implémentation de 'fmt::Debug' pour 'Structure'. 

2. // 'Structure' est une structure qui contient un simple entier de type 'i32'. 

3. #[dérivé(Debug)] 

4. struct Structure(i32); 

5. 

6. // On créé une structure nommée 'Deep', que l'on rend également affichable, 

7. // contenant un champ de type 'Structure', 

8. #[dérivé(Debug)] 

9. struct Deep (Structure); 

10 . 

11. fn main() ( 

12. // L'affichage avec le marqueur '{:?}' est similaire à '{)', 

13. // pour des types standards comme les entiers et les chaînes de caractères. 

14. println !("{:?} mois dans une année.", 12); 

15. println !("{1:?} (0:?} est le nom de factor:?}.", 

16. "Slater", 

17. "Christian", 

18. actor="l 1 acteur" ); 

19. 

20. // 'Structure' peut être affichée ! 

21. println !("{:?} peut désormais être affichée!". Structure(3)); 

22 . 

23. // Le problème avec 'dérivé' est que vous n'avez aucun contrôle quant au résultat 

24. // affiché. Comment faire si je souhaite seulement afficher '7' ? 

25. println !("{:?} peut désormais être affichée!", Deep ( Structure(7 ))); 

26. } 


Finalement, fmt::Debug permet de rendre un type personnalisé affichable en sacrifiant quelque peu « l'élégance » 
du résultat. Pour soigner cela, il faudra implémenter soit-même les services du traits fmt::Display. 

Voir aussi 

Les attributs, dérivé, std::fmt, les structures. 
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1-2-2 - Display 


fmt::Debug propose un formatage rudimentaire, et il peut être de bon ton de soigner ce que nous affichons. Pour ce 
faire, il faudra implémenter fmt::Display (qui utilise le marqueur {}). 

Voici un exemple d'implémentation du trait : 


1. // On importe (via 'use') le module 'fmt' pour le rendre accessible. 

2. use std::fmt; 

3. 

4. // Nous définissons une structure dans laquelle le trait 'fmt::Display' 

5. // sera implémenté. Ce n'est qu'un simple tuple, nommée 'Structure', contenant un entier de type i32. 

6. struct Structure(i32); 

7. 

8. // Pour pouvoir utiliser le marqueur '{}', le trait 'fmt::Display' doit être implémenté 

9. // manuellement pour le type. 

10. impi fmt::Display for Structure { 

11. fn fmt(&self, f: &mut fmt: :Formatter) -> fmt:: Resuit { 

12. // écrit le premier élément de la structure dans le flux en sortie 

13. // soumis: 'f'. Renvoie une instance de 'fmt::Resuit' qui témoigne du succès 

14. // ou de l'échec de l'opération. Notez que 'write!' possède une syntaxe très 

15. // similaire à 'println!'. 

16. write! (f, self.O) 

17. } 

18. } 


fmt::Display pourrait être plus lisible que fmt::Debug mais il présente un problème pour la bibliothèque standard. 
Comment les types ambiguës devraient être affichés ? Par exemple, si la bibliothèque standard devait implémenter 
un seul formatage pour toutes les « variantes » de Vec<T>, quel style devrait être choisi ? N'importe lequel ? 

1 Vec<Path> : /:/etc:/home/username:/bin (séparé par des « : ») ; 

2 Vec<i32> : 1,2,3 (séparé par des « , »). 

Bien sûr que non, puisqu'il n'y a pas de mise en forme idéale pour tous les types et la bibliothèque standard n'en 
impose pas. 

fmt::Display n'est pas implémenté pour la structure Vec<T> ni pour aucun autre conteneur générique. fmt::Debug 
doit alors être utilisé pour ces ressources. 

Ce n'est en revanche pas un problème pour les conteneurs(e.g. structures) qui ne sont pas génériques, fmt::Display 
peut être implémenté et utilisé. 


I. use std::fmt; // On importe le module "fmt' 

2 . 

3. // Une structure qui contient deux nombres. 'Debug' va être hérité pour que les résultats 

4. // puissent être comparés avec 'Display'. 

5. #[dérivé(Debug)] 

6. struct MinMax(i64, i64); 

7 . 

8. // Implémentation du trait 'Display' pour la structure 'MinMax'. 

9. impi fmt::Display for MinMax { 

10. fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { 

II. // On utilise 'self.nombre' pour faire référence à la donnée se trouvant 

12. //à cette position. 

13. write! (f, "(U, U)", self.O, self.l) 

14. } 

15. } 

16. 

17. // Définissons une structure où les champs sont nommés pour comparer. 

18. #[dérivé(Debug)] 

19. struct Point2D ( 

20. x: f64, 

21. y: f64, 

22. } 
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23. 

24. // On implémente également le trait fmt: : Display pour la structure Point2D 

25. impi fmt::Display for Point2D { 

26. fn fmt(&self, f: &mut fmt: :Formatter) -> fmt:: Resuit { 

27. // On désigne les champs de notre choix, (en l'occurrence 'x' et 'y') 

28. write! (f, "x: {}, y: {}", self.x, self. y) 

29. } 

30. } 

31. 

32. fn main() { 

33. let minmax = MinMax(0, 14); 

34. 

35. println !( "Comparaison des structures: ") ; 

36. println !( "Display: {}", minmax); 

37. println !( "Debug: {:?}", minmax); 

38. 

39. let big_range = MinMax(-300, 300); 

40. let small_range = MinMax(-3, 3); 

41. 

42. println! ("Le grand intervalle est {big} et le petit est {small}", 

43. small = small_range, 

44. big = big_range); 

45. 

46. let point = Point2D { x: 3.3, y: 7.2 }; 

47. 

48. println !( "Comparaison des points:"); 

49. println !( "Display: {}", point); 

50. println !( "Debug: {:?}", point); 

51. 

52. // Erreur. Les traits 'Debug' and 'Display' étaient implémentés mais 

53. // le marqueur '{:b}' requiert l'implémentation du trait 'fmt: :Binary'. 

54. // Cela ne fonctionnera pas. 

55. // println! ("A quoi ressemble Point2D formaté en binaire: {: b} ?", point); 

56. } 


Donc fmt::Display a été implémenté mais ce n'est pas le cas de fmt::Binary, il ne peut alors pas être utilisé. 

std::fmt possède de nombreux traits et chacun doit posséder sa propre implémentation. Pour plus d'informations, 
nous vous invitons à consulter la documentation du module. 

Activité 

Après avoir constaté le résultat de l'exemple ci-dessus, aidez-vous de la structure Point2D pour ajouter à l'exemple 
une nouvelle structure nommée Complex. Voici le résultat attendu lorsqu'une instance de la structure Complex sera 
affichée : 


Display: 3.3 + 7.2i 

Debug: Complex { real: 3.3, imag: 7.2 } 


Voir aussi 


L'attribut dérivé, std::fmt, les macros, les structures, les traits, le mot-clé use. 


1-2-2-1 - Exemple d'utilisation : La structure List 


Implémenter le trait fmt::Display pour une structure où les éléments doivent être gérés séquentiellement est assez 
délicat. Le problème réside dans le fait que chaque appel de la macro write! génère une instance de fmt::Result. 
Une bonne gestion de ces appels nécessite de tester chaque résultat. Rust vous permet de gérer les erreurs de 
deux manières : 

1 En utilisant la macro try! ; 

2 En utilisant l'opérateur ? (qui est l'équivalent de try! mais intégré directement au langage). 
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La macro try! vient envelopper la fonction (ou la macro) cible comme ceci : 

// On 'test' write! Pour voir si une erreur survient. S'il y a une erreur, 

// elle sera renvoyée. Sinon, l'exécution continue, 
try! (write!(f, "{}", value)); 

L'opérateur ?, bien qu'équivalent à la macro try!, vient se positionner devant l'appel de la fonction (ou macro). 

| writeT (f, value)?; 

Avec l'opérateur ?, l'implémentation du trait fmt::Display pour un Vec est simple et lisible. 


1. use std::fmt; // On importe le module 'fmt'. 

2 . 

3. 

4. // On déclare une structure nommée 'List' qui contient un 'Vec'. 

5. struct List(Vec<i32>); 

6. 

7. impi fmt:;Display for List { 

8. fn fmt(&self, f: &mut fmt: :Formatter) -> fmt::Result { 

9. //On extrait le premier champ de la structure. 

10. // Nous créons une référence de 'vec'. 

11. let vec = Sself.O; 

12 . 

13 . write ! (f, "[")?; 

14 . 

15. // On parcourt 'vec' en stockant chacun de ses éléments et 

16. //le nombre d'itérations. 

17. for (count, v) in vec.iter().enumerate() { 

18. // Pour tout élément, excepté le premier, on ajoute une virgule. 

19. // On utilise l'opérateur ?, ou la macro try!, pour renvoyer les erreurs. 

20. if count != 0 { write! (f, ", ")?; } 

21. write! (f, "{}", v)?; 

22. } 

23. 

24. // On ferme le crochet ouvert précédemment et on renvoie une instance 

25. // de la structure 'fmt::Resuit'. 

2 6 . write! (f, "]") 

27. } 

28. } 

29. 

30. fn main() { 

31. let v = List(vec![l, 2, 3] ); 

32. println !("{}" , v); 

33. } 


Activité 

Essayez de modifier le programme pour que l'index de chaque élément du vector soit également affiché durant 
l'exécution. Le résultat devrait ressembler à ceci : 

[0: 1, 1: 2, 2: 3] 

Voir aussi 

La boucle for, le pattern ref, Resuit, les structures, try!, vec!. 


1-2-3 - Formatage 


Nous avons vu que le formatage désiré était spécifié par des « chaînes de formatage » : 
• format!("{}", foo) -> "3735928559" ; 
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• format!("Ox{:X}", foo) -> "OxDEADBEEF" ; 

• format!("Oo{:o}", foo) -> "0o33653337357". 

La même variable (foo) peut être formatée de différentes manières suivant le type d'argument utilisé dans le marqueur 
(e.g. X, o, rien). 

Cette fonctionnalité est implémentée à l'aide de traits, et il y en a un pour chaque type d'argument. Le plus commun 
est, bien entendu, Display. Il est chargé de gérer les cas où le type d'argument n'est pas spécifié (i.e. {}). 


1. use std::fmt: :{ self , Formatter, Display}; 

2 . 

3. struct City { 

4. name: S'static str, 

5. // Latitude 

6. lat: f32, 

7. // Longitude 

8. ion: f32, 

9. } 

10. 

11. impi Display for City { 

12. // "f" est un tampon, cette méthode écrit la chaîne de caractères 

13. // formattée à l'intérieur de ce dernier. 

14. fn fmt(Sself, f: &mut Formatter) -> fmt::Result { 

15. let lat_c = if self. lat >=0.0 { 'N' } else { 'S' }; 

16. let lon_c = if self. Ion >= 0.0 { 'E' } else { 'W' }; 

17 . 

18. // 'write!' est équivalente à 'format!', à l'exception qu'elle écrira 

19. // la chaîne de caractères formatée dans un tampon (le premier argument). 

20. write! (f, "{}: {:.3}°{} { : . 3}°{} " , 

21. self. name, self .lat.abs(), lat_c, self .Ion.abs(), lon_c) 

22. } 

23. } 

24 . 

25. #[dérivé(Debug)] 

26. struct Color { 

27. red: u8, 

28. green: u8, 

29. blue: u8, 

30. } 

31. 

32. fn main() { 

33. for city in [ 

34. City { name: "Dublin", lat: 53.347778, Ion: -6.259722 }, 

35. City { name: "Oslo", lat: 59.95, Ion: 10.75 }, 

36. City { name: "Vancouver", lat: 49.25, Ion: -123.1 }, 

37. ].iter() { 

38. println !("{}" , *city); 

39. } 

40. for color in [ 

41. Color { red: 128, green: 255, blue: 90 }, 

42. Color { red: 0, green: 3, blue: 254 }, 

43. Color { red: 0, green: 0, blue: 0 }, 

44 . ] .iter() { 

45. // Utilisez le marqueur '{}' une fois que vous aurez implémenté 

46. // le trait fmt::Display. 

47. println! ("{:?}", *color) 

48. } 

49. } 


N'hésitez pas à consulter la liste complète des traits dédiés au formatage ainsi que leurs types d'argument dans 
la documentation du module std::fmt. 

Activité 


Implémentez le trait fmt::Display pour la structure Color dans l'exemple ci-dessus de manière à obtenir un résultat 
identique à celui-ci : 
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RGB (128, 255, 90) 0x80FF5A 
RGB (0, 3, 254) 0x0003FE 
RGB (0, 0, 0) 0x000000 


Indices : 

• Vous pourriez avoir besoin d'itérer plusieurs fois sur vos couleurs ; 

• Vous pouvez créer une « compensation » (remplissant votre chaîne de zéros) d'une largeur n avec :0n. 

Voir aussi 
std::fmt 


2 - Les primitifs 


Le langage Rust offre une grande variété de primitifs. Liste non-exhaustive : 

• Les entiers signés : i8, i 16, i32, i64 et isize (dépend de l'architecture de la machine) ; 

• Les entiers non-signés : u8, u16, u32, u64, usize (dépend de l'architecture de la machine) ; 

• Les réels : f32, f64 ; 

• Les caractères (Unicode) : 'a', 'a', '«>'. Codés sur 4 octets ; 

• Les booléens : true ou false ; 

• L'absence de type (), qui n'engendre qu'une seule valeur : () ; 

• Les tableaux : [1, 2, 3] ; 

• Les tuples : (1, true). 

Le type des variables peut toujours être spécifié. Les nombres peuvent également être typés grâce à un suffixe, ou 
par défaut (laissant le compilateur les typer). Les entiers, par défaut, sont typés i32 tandis les réels sont typés f64. 


1. fn main() { 

2. //Le type des variables peut être spécifié, annoté. 

3. let logical: bool = true; 

4 . 

5. let a_float: f64 = 1.0; // typage classique 

6. let an_integer = 5i32; // Typage par suffixe 

7 . 

8. //Le type par défaut peut également être conservé. 

9. // typage implicite 

10. let default_float =3.0; // "f64~ 

11. let default_integer =7; // "i32" 

12 . 

13. let mut mutable = 12; // Entier signé codé sur 4 octets (i32). 

14 . 

15. // Erreur! Le type d'une variable ne peut être modifié en cours de route. 

16. // mutable = true; 

17. } 


Voir aussi 

La bibliothèque standard. 


2-1 - Les littéraux et les opérateurs 


Les entiers (1), les réels (1,2), les caractères ('a'), les chaînes de caractères ("abc"), les booléens (true) et l'absence 
de type () (un tuple vide) peuvent être représentés en utilisant les littéraux. 

Les entiers peuvent également être exprimés sous différentes bases : hexadécimal, octal ou binaire en utilisant, 
respectivement, les préfixes : Ox, Oo ou 0b. 
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Des underscores peuvent être insérés à l'intérieur des littéraux numériques pour soigner la lisibilité (e.g. 1_000 est 
équivalent à 1000 et 0.000_001 est équivalent à 0.000001 ). 

Nous devons renseigner le compilateur quant au type de littéral que nous utilisons. Pour le moment, nous allons 
utiliser le suffixe u32 pour indiquer que le littéral est un entier non-signé codé sur 32 bits et le suffixe i32 pour indiquer 
que c'est un entier signé codé sur 32 bits. 


Les opérateurs et leur priorité dans le langage Rust peuvent être retrouvés dans les langages « C-like ». 


1. fn 

main() { 



2 . 

// Addition d'entiers 


3. 

A 

println! ( " 

1 + 2 = {}", lu32 + 2); 


4 . 

5. 

// Soustraction d'entiers 


6. 

7 

println! ( " 

1 - 2 = {}", li32 - 2); 


// 

8 . 

TODO A Essayez de changer 'li32' par 'lu32' pour 

prendre conscience de l'importance du type 

9. 

// Logique 

booléenne 


10. 

println! ( 

"true AND false is {}", true && false) ; 

11. 

println! ( 

"true OR false is {}", true 1| false) 

; 

12 . 

println! ( 

"NOT true is {}", !true); 


13. 




14 . 

// Opérations bit-à-bit 


15. 

println! ( 

"0011 AND 0101 is {:04b}", 0b0011u32 

& ObOlOl ); 

16. 

println! ( 

"0011 OR 0101 is {:04b}", 0b0011u32 | 

ObOlOl ); 

17 . 

println! ( 

"0011 XOR 0101 is {:04b}", 0b0011u32 

A ObOlOl) ; 

18. 

println! ( 

"1 « 5 is {}", lu32 « 5) ; 


19. 

println! ( 

"0x80 >> 2 is 0x{:x}", 0x80u32 >> 2); 


20. 




21. 

// Utilisez des underscores pour améliorer la 

lisibilité ! 

22 . 

23. } 

println! ( 

"One million is written as {}", 1 000 

_000u32); 


2-2 - Les tuples 


Un tuple est une collection de valeurs de différents types (ou pas). Les tuples peuvent être construits en utilisant 
les parenthèses () et chaque tuple est lui-même un type possédant sa propre signature (Tl, T2, ...), où Tl, T2 sont 
les types de ses membres. Les fonctions peuvent se servir des tuples pour renvoyer plusieurs valeurs, puisque ces 
derniers peuvent être extensibles à volonté. 


î. 

2 . 
3. 

4 . 

5. 

6 . 

7 . 
8 . 

9. 

10 . 
11. 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21. 
22 . 
23. 
24 . 
25. 


// Les tuples peuvent être utilisés comme arguments passés à une fonction 
// et comme valeurs de renvoi. 

fn reverse(pair: (i32, bool)) -> (bool, i32) { 

// 'let' peut être utilisé pour assigner, lier les membres d'un tuple à des 
// variables. 

let (integer, boolean) = pair; 

(boolean, integer) 

} 


//La structure suivante est dédiée à l'activité. 
#[dérivé(Debug)] 

struct Matrix(f32, f32, f32, f32); 


fn main() { 

//Un tuple composé de différents types 

let long_tuple = (lu8, 2ul6, 3u32, 4u64, 

-li8, -2il6, -3i32, -4i64, 

0 . If32, 0 . 2f 64, 

' a ' , true) ; 

// Les valeurs peuvent être extraites depuis le tuple en utilisant son 
// indexation. 

println! ("long tuple first value: {}", long_tuple.0); 
println! ("long tuple second value: {}", long_tuple.1); 
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26. 




27 . 

// Les tuples peuvent être 

eux-même 

des membres d'un tuple. 

28. 

let tuple of tuples = ( (lu8 

, 2ul6, 

2u32), (4u64, -li8), -2il6) ; 

29. 




30. 

// Les tuples peuvent être 

affichés 

avec Debug. 

31. 

println !( "tuple of tuples: 

{:?}", tuple of tuples); 

32. 




33. 

let pair = (1, true) ; 



34. 

println !( "pair is {:?}", pair); 


35. 




36. 

println! ("the reversed pair 

is {:?} 

", reverse(pair)); 

37. 




38. 

// Pour créer un élément de 

tuple, 

une virgule est requise pour différencier 

39. 

// un élément de tuple d'un 

simple 

litéral entouré de parenthèses. 

40. 

println! ("one element tuple 

: {:?}", 

(5u32,)); 

41. 

println !( "just an integer: 

{:?}", (5u32)); 

42 . 




43. 

// Les tuples peuvent être 

"déstructurés" (i.e. décomposés pour créer de 

44 . 

// nouvelles assignations). 



45. 

let tuple = (1, "hello", 4. 

5, true) 

; 

46. 




47 . 

let (a, b, c, d) = tuple; 



48. 

println! ("{ :?}, {:?}, {:?}, 

{:?}", 

a, b, c, d) ; 

49. 




50. 

let matrix = Matrix(1.1, 1. 

2, 2.1, 

2.2); 

51. 

println! ("{:?}", matrix) 



52. 




53. } 





Activité 

1 Récapitulatif : Implémentez les services du trait fmt::Display pour la structure Matrix dans l'exemple ci-dessus. 
Donc si vous passez de l'affichage de débogage {:?} à l'affichage plus « user friendly » {}, vous devriez voir le 
résultat suivant : 


( 1.1 1.2 ) 

( 2.1 2.2 ) 


Vous pouvez vous référer à l'exemple précédemment donné pour l'implémentation du trait Display. 


1 Ajoutez une fonction transpose(), en vous appuyant sur l'implémentation de la fonction reverse(), qui accepte 
une matrice en paramètre et renvoie une matrice dans laquelle deux éléments ont été inversés. Exemple : 


println ! 

( "Matrix :\n{}" , 

matrix); 

println ! 

("Transpose:\n{ 

}", transpose (matrix)); 


Affiche : 


1. Matrix: 

2 . ( 1 . 11 . 2 ) 

3. ( 2.1 2.2 ) 

4. Transpose: 

5. ( 1.1 2.1 ) 

6 . ( 1.2 2.2 ) 


2-3 - Les tableaux et les "slices" 


Un tableau est une collection d'objets appartenant au même type T, contenu dans un bloc mémoire défragmenté. 
Vous pouvez créer un tableau en utilisant les crochets [] et leur taille, connue à la compilation, fait partie intégrante 
de la signature du type [T; taille]. 
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Note : Le terme « slice », en français, pourrait être traduit par « morceau », « tranche », g. 
Pour la suite du chapitre, nous utiliserons le terme « slice ». 


Les slices sont similaires aux tableaux, à l'exception de leur taille qui n'est pas connue à la compilation. Une slice est 
un objet composé de deux « mots », le premier étant un pointeur vers la ressource initiale et le second étant la taille 
de la slice. La taille en mémoire de la slice est déterminée par l'architecture du processeur (e.g. 64 bits pour une 
architecture x86-64). Les slices peuvent être utilisées pour isoler une partie d'un tableau et héritent de la signature 
de ce dernier &[T]. 


1 . use 

2 . 

std::mem; 



3. 

4. // 

Cette fonction emprunte une slice. 



5. fn 

analyze slice(slice: &[ i32]) { 



6 . 

println! ("first element of the slice: {}", slice[0]); 



7 . 

8 . } 

println ! ( "the slice has {} éléments", slice.len()); 



9. 

10 . fn 

main() { 



11 . 

// Tableau dont la taille est connue à la compilation (le 

type 

peut être omis). 

12 . 

let xs: [i32; 5] = [1, 2, 3, 4, 5]; 



13. 




14 . 

// Tous les éléments peuvent être initialisés à la même valeur. 


15. 

let ys: [i32; 500] = [0; 500] ; 



16. 




17 . 

// L'indexation débute à 0. 



18. 

println !( "first element of the array: {}", xs[0]); 



19. 

println !( "second element of the array: {}", xs[l]); 



20 . 




21 . 

// 'len' renvoie la taille du tableau. 



22 . 

println !( "array size: {}", xs.len()); 



23. 




24 . 

// Les tableaux sont alloués dans la pile. 



25. 

println! ("array occupies {} bytes", mem::size of val(Sxs)) 

; 


26. 




27 . 

// Les tableaux peuvent être automatiquement empruntés en 

tant 

que 

28. 

// slice. 



29. 

println! ("borrow the whole array as a slice"); 



30. 

analyze slice (Sxs); 



31. 




32. 

// Les slices peuvent pointer sur une partie bien précise 

d'un 

tableau. 

33. 

println! ("borrow a section of the array as a slice"); 



34. 

analyze slice (&ys[l .. 4]); 



35. 




36. 

// Erreur! Le dépassement de tampon fait planter le programme. 


37. 

// println! ("{ }", xs[5]); 



38. } 





3 - Les types personnalisés 


En Rust, les types de données personnalisés sont principalement créés à partir de ces deux mots-clés : 

1 struct : Définit une structure ; 

2 enum : Définit une énumération. 

Les constantes peuvent également être créées via les mots-clés const et static. 


3-1 - Les structures 


Il y a trois types de structures pouvant être créé en utilisant le mot-clé struct : 
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1 Les « tuple structs », aussi appelées simplement tuples ; 

2 Les structures classiques issues du langage C ; 

3 Les structures unitaires. Ne possédant aucun champ, elles sont utiles pour la généricité. 


1. 

// Une 

structure 

unitaire. 

2 . 

3. 

struct 

Nil; 


4 . 

//Un tuple. 


5. 

6. 

struct 

Pair(132, 

f 32 ) ; 

7 . 

// Une 

structure 

avec deux champs 

8. 

struct 

Point { 


9. 

x : 

f 32, 


10 

y 

: f 32, 



n. l 

12 . 

13. // Les structures peuvent faire partie des champs d'une autre structure. 

14. #[allow(dead_code)] 

15. struct Rectangle { 

16. pl: Point, 

17. p2: Point, 

18. } 

19. 

20 . fn main() { 

21. // On instancie la structure 'Point'. 

22. let point: Point = Point { x: 0.3, y: 0.4 }; 

23. 

24. // On accède aux champs du point. 

25. println! ("point coordinates: ({}, {})", point.x, point.y); 

26. 

27. // On décompose les champs de la structure pour les assigner 

28. // à de nouvelles variables (i.e. my_x et my_y) 

29. let Point { x: my_x, y: my_y } = point; 

30. 

31. let _rectangle = Rectangle { 

32. // L'instanciation de la structure est également une expression. 

33. pl: Point { x: my_y, y: my_x }, 

34. p2: point, 

35. } ; 

36. 

37. // On instancie la structure unitaire, vide. 

38. let _nil = Nil; 

39. 

40. // On instancie un tuple. 

41. let pair = Pair(l, 0.1); 

42 . 

43. // Accède aux champs du tuple. 

44. println !( "pair contains {:?} and {:?}", pair.O, pair.l); 

45. 

46. //On décompose un tuple. 

47. let Pair(integer, décimal) = pair; 

48. 

49. println! ("pair contains {:?} and {:?}", integer, décimal); 

50. } 


Activité 

1 Ajoutez une fonction rect_area qui calcule l'air d'un rectangle (essayez d'utiliser la déstructuration) ; 

2 Ajoutez une fonction square qui prend en paramètre une instance de la structure Point et un réel de type f32 
puis renvoie une instance de la structure Rectangle contenant le point du coin inférieur gauche du rectangle 
ainsi qu'une largeur et une hauteur correspondant au réel passé en paramètre à la fonction square. 

Voir aussi 

Les attributs et la déstructuration. 
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3-2 - Les énumérations 


Le mot-clé enum permet la création d'un type qui peut disposer d'une ou plusieurs variantes de lui-même. Toutes les 
variantes des structures sont valides dans une énumération. 


1. 
2 . 
3. 
4 . 

5. 

6 . 
7 . 


// Masque les avertissements du compilateur lorsqu'il y a 
// du code mort présent dans votre code. 

#![allow(dead_code)] 

// On créé une énumération pour définir des "classes" de personnes. 

// Notez que chaque variante de l'énumération est indépendante de l'autre. 
// Aucune n'est égale à l'autre: 'Engineer != Scientist' et 
// 'Height(i32) != Weight(132)'. 

Person { 

// Une variante peut être une structure unitaire, 

Engineer, 

Scientist, 

//un tuple 
Height(i32), 

Weight(i32), 

// ou simplement une structure classique. 

Info { name: String, height: i32 } 


9. 

enum 

10 . 


11 . 


12 . 


13. 


14 . 


15. 


16. 


17 . 


18. 

} 

19. 


20 . 

// ) 

21 . 

// ) 

22 . 

fn : 

23. 


24 . 


25. 


26. 


27 . 


28. 


29. 


30. 


31. 


32. 


33. 


34. 


35. 


36. 


37. 


38. 

} 

39. 


40. 

fn i 

41. 


42 . 


43. 


44 . 


45. 


46. 


47 . 


48. 


49. 


50. 


51. 


52. 


53. 


54. 

} 


Prend une variante de 
ne renvoie rien. 


l'énumération 'Person' en argument et 


// En utilisant une énumération, vous devez analyser tous les cas 
// possibles (obligatoire). 

// Le pattern matching permet de les couvrir efficacement, 
match p { 

Person::Engineer => println! ("Is an engineer!"), 

Person::Scientist => println! ("Is a scientist!"), 

//On récupère l'attribut de l'instance 'Height'. 

Person::Height(i) => println !( "Has a height of {}.", i), 
Person::Weight(i) => println !( "Has a weight of {}.", i) , 

// Déstructuré 'Info' into 'name' and 'height'. 

//On récupère les attributs 
Person::Info { name, height } => { 

println! ("{} is {} tall!", name, height); 

}, 

} 


let person 
let amira 
// La fonction 


String' 

à partir d'une slice (i.e. &str). 
Dave" .to_owned(), height: 72 }; 


= Person::Height ( 1 8 ); 

= Person::Weight( 10 ); 

‘to_owned()' créé une instance de la structure 
// possédée par l'assignation 'name 

let dave = Person::Info { name: 

let rebecca = Person::Scientist; 
let rohan = Person::Engineer; 

inspect(person); 
inspect(amira); 
inspect(dave); 
inspect(rebecca); 
inspect(rohan); 


Voir aussi 

Les attributs, le mot-clé match, le mot-clé fn, les chaînes de caractères. 
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3-2-1 - Le mot-clé use 


Grâce au mot-clé use, il n'est pas toujours obligatoire de spécifier le contexte d'une ressource à chaque utilisation. 


1. // Masque les avertissements du compilateur concernant le code mort. 

2 . #![allow(dead_code)] 

3. 

4. enum Status { 

5. Rich, 

6 . Poor, 

7. } 

8 . 

9. enum Work { 

10. Civilian, 

11. Soldier, 

12 . } 

13. 

14. fn main ( ) { 

15. // Nous précisons que ces variantes de l'énumération sont utilisées, donc 

16. // il n'est plus nécessaire de préciser leur conteneur. 

17. use Status::{Poor, Rich}; 

18. // On utilise automatiquement toutes les variantes de l'enum 'Work'. 

19 . use Work : : * ; 

20 . 

21. // Equivalent à 'Status::Poor'. 

22. let status = Poor; 

23. // Equivalent à 'Work::Civilian'. 

24. let work = Civilian; 

25. 

26. match status { 

27. // Notez la disparition du conteneur lors de la recherche de pattern. 

28. Rich => println! ("The rich hâve lots of money!"), 

29. Poor => println! ("The poor hâve no money..."), 

30. } 

31. 

32. match work { 

33. // Une fois encore, le conteneur a disparu. 

34. Civilian => println! ("Civilians work!"), 

35. Soldier => println! ("Soldiers fight!"), 

36. } 

37. } 


Voir aussi 

Le mot-clé match et la déclaration use. 


3-2-2 - Énumérations "C-like" 


Les énumérations du langage Rust peuvent également adopter la même syntaxe que celles du langage C (possédant 
un identifiant explicite). 


1. //Un attribut qui masque les avertissements du compilateur 

2 . // concernant le code mort. 

3. #![allow(dead_code)] 

4. 

5. // Énumération avec un identifiant implicite (partant de 0). 

6 . enum Number { 

7. Zéro, // 0 

8. One, // 1 

9. Two, // 2 

10 . } 

11. 

12 . // Énumération avec un identifiant explicite. 

13. enum Color { 

14. Red = OxffOOOO, 

15. Green = OxOOffOO, 
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16. Blue = OxOOOOff, 

17. } 

18. 

19. fn main() { 

20. // Les variantes d'une énumération peuvent être converties en entiers. 

21. println! ( " zéro is {}", Number::Zero as i32); 

22. println !( "one is {}", Number::One as i32); 

23. 

24. println !( "roses are #{:06x}", Color::Red as i32); 

25. println !( "violets are #{:06x}", Color::Blue as i32); 

26. } 


Voir aussi 
Le casting. 


3-2-3 - Exemple d'utilisation : « linked-list » 


Voici un exemple dans lequel une énumération peut être utilisée pour créer une liste de nœuds : 


1. use List : : * ; 

2 . 

3. enum List { 

4 . 

// Cons: Un tuple contenant un élément(i.e. u32) et un pointeur vers le noeud suivant 

5. Cons(u32, Box<List>), 

6 . // Nil: Un noeud témoignant de la fin de la liste. 

7. Nil, 


(i.e. 



9. 

10. // Il est possible de lier, d'implémenter des méthodes 

11 . // pour une énumération. 


12. impi List { 


13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 


// Créé une liste vide, 
fn new() -> List { 

// "Nil" est une variante de "List". 

Nil 

} 

// Consomme, s'approprie la liste et renvoie une copie de cette même liste 
// avec un nouvel élément ajouté à la suite, 
fn prepend (self , elem: u32) -> List { 

// 'Cons' est également une variante de 'List'. 

Cons(elem, Box ::new( self )) 

} 

// Renvoie la longueur de la liste, 
fn len(Sself) -> u32 { 

// 'self' doit être analysé car le comportement de cette méthode 
// dépend du type de variante auquel appartient 'self'. 

// 'self' est de type '&List' et '*self' est de type 'List', rendant 


// possible l'analyse directe de la ressource plutôt que par le biais d'un alias (i.e. une 

32 . // Pour faire simple: on déréférence 'self' avant de l'analyser. 

33. // Note: Lorsque vous travaillez sur des références, préférez le déréférencement 

34. // avant analyse. 

35. match *self { 

36 . // On ne peut pas prendre "1'ownership" de la queue (liste) 

37 . // puisque l'on emprunte seulement 'self' (nous ne le possédons pas); 

38 . // Nous créerons simplement une référence de la queue. 

39. Cons(_, ref tail) => 1 + tail.len(), 

40. // De base, une liste vide possède 0 élément. 

41. Nil => 0 

42. } 

43. } 

44 . 

45. // Renvoie une représentation de la liste sous une chaîne de caractères 

46. // (wrapper) 


réf éret 
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47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 

59. 

60. 
61. 
62. 

63. 

64. 

65. 

66 . 

67. 

68 . 

69. 

70. 

71. 
72 . 
73. 
74 . 


fn stringify(Sself) -> String { 
match *self { 

Cons(head, ref tail) => { 

// 'format!' est équivalente à 'println!' mais elle renvoie 
// une chaîne de caractères allouée dans le tas (wrapper) 

// plutôt que de l'afficher dans la console, 
format! ("{}, {}", head, tail.stringify()) 

}, 

Nil => { 

format ! ( "Nil" ) 


} 


fn main() { 

// Créé une liste vide, 
let mut list = List::new(); 

// On ajoute quelques éléments. 

list = list.prepend( 1 ); 
list = list.prepend( 2 ); 
list = list.prepend(3); 


// Affiche l'état définitif de la liste. 

println! ("La linked list possède une longueur de: {}", list.lenO), 
println !("{}", list.stringify()); 


Voir aussi 


Box, les méthodes. 


3-3 - Les constantes 


Rust possède deux types de constantes qui peuvent être déclarées dans n'importe quel contexte global. 

Chacun dispose d'un mot-clé : 

• const : Une valeur immuable (état par défaut de toute variable) ; 

• static : Une variable pouvant être accédée en lecture et (accessoirement) en écriture possédant la « lifetime » 
’static. 

Exception pour les "chaînes de caractères" littérales qui peuvent être directement assignées à une variable statique 
sans modification de votre part, car leur type &'static str dispose déjà de la lifetime 'static. Tous les autres types de 
référence doivent être explicitement annotés pour étendre leur durée de vie. 


1. // Les variables globales sont déclarées en dehors de tous contextes. 

2. static LANGUAGE: &' static str = "Rust"; 

3. const THRESHOLD: i32 = 10; 

4 . 

5. fn 

6 . 

7 . 

8 . } 

9. 

10 . fn main() { 

11 . let n = 16; 

12 . 

13. // Accès à la constante dans le fil d'exécution principal. 

14. println! ("This is {}", LANGUAGE); 

15. println! ("The threshold is {}", THRESHOLD); 

16. println! ("{} is {}", n, if is_big(n) { "big" } else { "small" }); 
17 . 

18. // Erreur! Vous ne pouvez pas modifier une constante. 


is_big(n: i32) -> bool { 

// Accès à la constante dans une fonction, 
n > THRESHOLD 
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19. 

// 

THRESHOLD = 5; 

20. 

// 

FIXME A Commentez cette ligne pour voir disparaître 

21. 

// 

le message d'erreur. 

22. } 




Voir aussi 


La RFC des mot-clés const et static, la lifetime 'static. 


4 - Les assignations 


Rust assure l'immuabilité du type d'une variable grâce au typage statique. Lorsqu'une variable est déclarée elle peut 
être typée. Cependant, dans la plupart des cas, le compilateur sera capable d'inférer le type de la variable en se 
basant sur le contexte, atténuant sérieusement la lourdeur du typage. 

Les valeurs (tels que les littéraux) peuvent être assignées à des variables en utilisant le mot-clé let. 


i. 

fn main() { 


2 . 

let an integer = lu32; 


3. 

let a boolean = true; 


4 . 

C 

let unit = () ; 


D . 

6 . 

// Copie 'an integer' dans 'copied integer'. 


7 . 

8 . 

let copied integer = an integer; 


9. 

println! ("An integer; {:?}", copied integer); // un entier 


10 . 

println! ("A boolean; {:?}", a boolean); // un booléen 


11 . 

println! ("Meet the unit value: {:?}", unit); // rien 


12 . 



13. 

// Le compilateur vous alertera lorsqu'il détecte une variable 

inutilisée; 

14 . 

// Vous pouvez faire taire ces avertissements en préfixant l'identificateur 

15. 

// de la variable avec un underscore (i.e. ). 


16. 

let unused variable = 3u32; 


17 . 



18. 

let noisy unused variable = 2u32; 


19. 

// FIXME A Préfixez cet identificateur avec un underscore pour 

supprimer 

20 . 

// l'avertissement. 


21 . 

. } 



4-1 - Mutabilité 


L'assignation à une variable est immuable par défaut mais ceci peut être changé en utilisant le modificateur mut. 


i. 

fn main() { 



2 . 

let immutable binding = 1 ; 



3. 

4 

let mut mutable binding = 1 ; 



5. 

c 

println! ("Avant modification: 

U", 

mutable binding); 

U . 

7 . 

// Ok 



8 . 

q 

mutable binding += 1 ; 



y . 

10 . 

println! ("Après modification: 

: U", 

mutable binding); 

11 . 




12 . 

// Erreur! 



13. 

// immutable binding += 1 ; 



14 . 

// FIXME A Décommentez cette 

ligne 

pour voir le message d'erreur 

15. 

. } 
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4-2 - Scope et shadowing 


Les assignations possèdent un contexte dans lequel elles persisteront et qui sera représenté par un « bloc ». Un bloc 
est une suite d'instructions et de déclarations englobées par des accolades {}. Le shadowing est également permis. 


1 . 

fn main() { 



2 . 

// Cette assignation vit dans la fonction 'main'. 



3. 

4 _ 

let long lived binding = 1 ; 



5. 

// Ceci est un bloc, il possède un contexte plus petit 

que celui de la 

fonction 

6 . 

7 . 

// 'main'. 



8 . 

t 

// Cette assignation existe seulement dans ce bloc 



9. 

let short lived binding = 2 ; 



10 




11 

println! ("inner short: {}", short lived binding); 



12 




13 

// Cette assignation *masque* l'assignation du contexte supérieur 

(la fonction 

14 

// 'main'). 



15 

let long lived binding = 5 f32; 



16 




17 

println! ("inner long: {}", long lived binding); 



18 

} 



19 

// Fin du bloc. 



20 




21 

// Erreur! 'short lived binding' n'existe pas dans ce 

contexte. 


22 

// println! ("outer short: {}", short lived binding); 



23 

// FIXME A Décommentez cette ligne pour voir l'erreur 



24 




25 

println! ("outer long: {}", long lived binding); 



26 




27 

// Cette assignation *masque* également l'assignation 

précédente. 


28 

let long lived binding = 'a'; 



29 




30 

println! ("outer long: {}", long lived binding); 



31 

} 




4-3 - Déclaration seule 


Il est possible de déclarer une variable dans un premier temps, pour l'initialiser dans un second temps. Cependant, 
cette forme est rarement utilisée puisqu'elle peut conduire à l'utilisation de variables qui ne sont pas initialisées (et 
donc à faire des erreurs). 

1 . fn main ( ) { 

2. //On déclare une variable. 

3. let a_binding; 

4. 

5. { 

6 . let x = 2 ; 

7. 

8 . //On initialise la variable. 

9. a_binding = x * x; 

10 . } 

11. 

12. println! ("a binding: {}", a_binding) ; 

13. 

14. let another_binding; 

15. 

16. // Erreur! Utilisation d'une variable non-initialisée. 

17. // println!("another binding: {}", another_binding); 

18. // FIXME A Décommentez cette ligne pour voir l'erreur. 

19. another_binding = 1; 

20 . 

21. println! ("another binding: {}", another_binding); 

22 . } 
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Comme l'utilisation d'une variable, qui n'a pas été initialisée au préalable, peut mener à des comportements 
imprévisibles à l'exécution, le compilateur vous interdit de les utiliser. 


5 - Le casting 


Rust ne permet pas la conversion implicite des types primitifs (coercition). En revanche, une conversion explicite 
(casting) peut être entreprise à l'aide du mot-clé as. 

Les règles régissant la conversion entre les types littéraux s'inspirent, principalement, des conventions du langage 
C à l'exception des cas où le C réserve des comportements imprévisibles. 


1 . // 

Supprime tous les avertissements relatifs aux dépassements 


2 . // 

de capacité (e.g. une variable de type u8 ne peut pas 


3. // 

contenir plus qu'une variable de type ul6). 


4. # ! 

5. 

[allow(overflowing literals)] 


6 . f n 

main() { 


7. 

Q 

let décimal = 65.4321 f32; 


O . 

9. 

// Erreur! La conversion implicite n'est pas supportée. 


10 . 

// let integer: u8 = décimal; 


11 . 

// FIXME A Décommentez/Commentez cette ligne pour voir 


12 . 

// le message d'erreur apparaître/disparaître. 


13. 



14 . 

// Conversion explicite. 


15. 

let integer = décimal as u8; 


16. 

let character = integer as char; 


17 . 



18. 

19. 

20 . 

println !( "Casting: {} -> {} -> {}", décimal, integer, character); 


// Lorsque vous convertissez une valeur vers un type 


21 . 

// non-signé T, std::T::MAX + 1 est incrémenté ou soustrait jusqu'à 

22 . 

// ce que la valeur respecte la capacité du nouveau type. 


23. 



24 . 

// 1000 ne dépasse pas la capacité d'un entier non-signé codé sur 

16 bits. 

25. 

println! ("1000 as a ul6 is: {}", 1000 as ul6); 


26. 



27 . 

// 1000 - 256 - 256 - 256 = 232 


28. 

// En réalité, les 8 premiers bits les plus faibles (LSB) sont conservés et les 

29. 

// bits les plus forts (MSB) restants sont tronqués. 


30. 

println! ("1000 as a u8 is : {}", 1000 as u8); 


31. 

// -1 + 256 = 255 


32. 

println!)" -1 as a u8 is : {}", (—118) as u8); 


33. 



34. 

// Pour les nombres positifs, cette soustraction est équivalente 

à une 

35. 

// division par 256. 


36. 

println! ("1000 mod 256 is : {}", 1000 % 256); 


37. 



38. 

// Quand vous convertissez un type d'entiers signés, le résultat 

(bit à bit) 

39. 

40. 

41. 

42 . 

// est équivalent à celui de la conversion vers un type d'entiers 
// Si le bit de poids fort vaut 1, la valeur sera négative. 

non-signés. 

// Sauf si il n'y a pas de dépassements, évidemment. 


43. 

println!)" 128 as a il6 is: {}", 128 as il6); 


44 . 

// 128 as u8 -> 128, complément à deux de 128 codé sur 8 bits: 


45. 

println!)" 128 as a i8 is : {}", 128 as i8); 


46. 



47 . 

// On répète l'exemple ci-dessus. 


48. 

// 1000 as u8 -> 232 


49. 

println! ("1000 as a i8 is : {}", 1000 as i8); 


50. 

// et le complément à deux de 232 est -24. 


51. 

println!)" 232 as a i8 is : {}", 232 as i8); 


52. 



53. 



54. } 
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5-1 - Les littéraux 


Les littéraux numériques peuvent être typés en suffixant le littéral avec son type. Par exemple, pour préciser que le 
littéral 42 devrait posséder le type i32, nous écrirons 42i32. 

Le type des littéraux numériques qui ne sont pas suffixés va dépendre du contexte dans lequel ils sont utilisés. S'il 
n'y a aucune contrainte (i.e. si rien ne force la valeur à être codée sur un nombre de bits bien précis), le compilateur 
utilisera le type i32 pour les entiers et f64 pour les nombres réels. 


1 . fn main() { 

2 . // Ces littéraux sont suffixés, leurs types sont connus à l'initialisation. 

3. let x = lu 8 ; 

4. let y = 2u32; 

5. let z = 3f32; 

6 . 

7. // Ces littéraux ne sont pas suffixés, leurs types dépendent du contexte. 

8 . let i = 1 ; 

9. let f = 1.0; 

10 . 

11. // La fonction 'size of val' renvoie la taille d'une variable en octets. 


12 . 

println! 

, " Let 

taille 

de 

' x ' 

en 

octets : 

U" 

std: 

:mem: 

: size 

of 

val(Sx)) ; 

13. 

println! 

, " Let 

taille 

de 

'y' 

en 

octets : 

U" 

std: 

:mem: 

: size 

of 

val (&y)); 

14 . 

println! 

, n Let 

taille 

de 

' z ' 

en 

octets : 

U" 

std: 

:mem: 

: size 

of 

val (&z)); 

15. 

println! 

, n Let 

taille 

de 

' i ' 

en 

octets : 

U" 

std: 

:mem: 

: size 

of 

val (Si) ) ; 

16. 

println! 

, " La. 

taille 

de 

'f ' 

en 

octets : 

U" 

std: 

:mem: 

: size 

of 

_val (&f) ) ; 


17. } 


Certains concepts présentés dans l'exemple ci-dessus n'ont pas encore été abordés. Pour les plus impatients, voici 
une courte explication : 

• fun(&foo) : Cette syntaxe représente le passage d'un paramètre par référence plutôt que par valeur (i.e. 
fun(foo)). Pour plus d'informations, voir le chapitre du système d'emprunts. 

• std::mem::size_of_val est une fonction mais appelée avec son chemin absolu. Le code peut être divisé et 
organisé en plusieurs briques logiques nommées modules. Pour le cas de la fonction size_of_val, elle se 
trouve dans le module mem, lui-même se trouvant dans le paquet std. Pour plus d'informations voir les 
modules et/ou les « crates ». 


5-2 - L'inférence des types 


Le moteur dédié à l'inférence des types est très intelligent. Il fait bien plus que d'inférer le type d'une r-value à 
l'initialisation. Il se charge également d'analyser l'utilisation de la variable dans la suite du programme pour inférer 
son type définitif. Voici un exemple plus avancé dédié à l'inférence : 


1 . 

fn main() { 


2 . 

// Dû à 1 ' annotation(suffixe), le compilateur sait que 'elem' possède 

le type 

3. 

// u 8 . 


4 . 

C 

let elem = 5u8; 


D . 

6 . 

// Crée un vecteur vide (un tableau dont la taille n'est pas définie). 


7 . 

let mut vec = Vec: :new(); 


8 . 

// À ce niveau, le compilateur ne connaît pas encore le type exact de 

'vec', 

9. 

10 . 

// il sait simplement que c'est un vecteur de quelque chose ('Vec<_>') 


11 . 

// On ajoute 'elem' dans le vecteur. 


12 . 

vec.push(elem); 


13. 

// Tada! Maintenant le compilateur sait que 'vec' est un vecteur 


14 . 

// d'entiers non-signés typés 'u 8 ' ('Vec<u 8 >'). 


15. 

16. 

17 . 

// TODO A Essayez de commenter la ligne où se trouve 'vec.push(elem) 


println !("{:?}" , vec); 


18. 

. 1 
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Aucun typage explicite n'était nécessaire, le compilateur est heureux et le programmeur aussi ! 


5-3 - Les alias 


Le mot-clé type peut être utilisé pour donner un nouveau nom à un type existant. Les types doivent respecter la 
convention de nommage CamelCase ou le compilateur vous renverra un avertissement. L'exception à cette règle 
sont les types primitifs : usize, f32, etc. 


1 . 

// 'NanoSecond' est le nouveau nom de 'u64'. 


2 . 

type NanoSecond = u64; 


3. 

4 _ 

type Inch = u64; 


5. 

// Utilisons un attribut pour faire taire les 


6 . 

// avertissements. 


7 . 

#[allow(non camel case types)] 


8 . 

type u64 t = u64; 


9. 

// TODO A Essayez de supprimer l'attribut. 


10 , 



11 , 

. fn main() { 


12 , 

// 'NanoSecond' = 'Inch' = 'u64 t' = 'u64'. 


13, 

let nanoseconds: NanoSecond = 5 as u64 t; 


14 , 

let inches: Inch = 2 as u64 t; 


15, 



16, 

// Notez que les alias de types ne fournissent aucune sécurité 

supplémentaire, 

17 , 

// car ce ne sont pas de nouveaux types (i.e. vous pouvez très 

bien changer 

18, 

// Inch par NanoSecond, vous n'aurez aucune erreur). 


19, 

println! ("{} nanoseconds + {} inches = {} unit?". 


20 , 

nanoseconds, 


21 

inches, 


22 , 

nanoseconds + inches); 


23, 

. } 



Voir aussi 
Les attributs. 


6 - Les expressions 


Un programme écrit en Rust est (principalement) composé d'une série de déclarations : 


i. 

fn main() { 

2 . 

// 

déclaration 

3 . 

// 

déclaration 

4 . 

// 

déclaration 

5 . 

} 



Il y a plusieurs sortes de déclarations en Rust. Les deux plus communes sont les assignations et les expressions 
suivies par un point-virgule « ; » : 

1 . fn main() { 

2 . // assignation 

3. let x = 5 ; 

4 . 

5. // expression; 

6. x; 

7. x + 1; 

8 . 15; 

9. } 

Les blocs sont également des expressions, donc ils peuvent être utilisés comme r-value dans les assignations. La 
dernière expression dans le bloc sera assignée à la l-value. Notez toutefois que si la dernière expression du bloc se 
termine par un point-virgule « ; », la valeur de renvoi sera (). 
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1. 

fn main() { 




2 . 

let x = 5u32; 



3. 





4 . 

let y = { 




5. 

let x 

squared = x * x; 


6. 

let x 

cube = x squared * x; 


7 . 





8. 

// Cette 

expression sera assignée à 

'y' • 

9. 

x cube 

+ 

x squared + x 


10. 

} ; 




11. 





12 . 

let z = { 




13. 

// Le 

point-virgule supprime cette 

expression et () est assigné 

14 . 


' z ' 



15. 

2 * x 

; 



16. 

} ; 




17 . 





18. 

println! ( 

"x 

is {:?}", x); 


19. 

println! ( 

"y 

is {:?}", y); 


20. 

println! ( 

” z 

is {:?}", z); 


21. 

■ } 





7 - Contrôle du flux 


La caractéristique commune à tous langages est la capacité à contrôler le flux : if/else, for, etc., et Rust ne fait pas 
exception. Allons voir ça ! 


7-1 - If/else 


Les branchements conditionnels tels que if ou else sont similaires à d'autres langages. Contrairement à beaucoup 
d'entre-eux, la condition booléenne peut toutefois ne pas être enveloppée de parenthèses et chaque condition est 
suivie d'un bloc. Les conditions if/else sont des expressions et toutes les branches doivent renvoyer le même type. 


i. 

fn main() { 


2 . 

O 

let n = 5; 


O . 

4 . 

if n < 0 { 


5. 

print!("{} est négatif.", n) ; 


6. 

} else if n > 0 { 


7 . 

print!("{} est positif.", n); 


8. 

} else { 


9. 

print!("{} est nul.", n); 


10. 

11. 

} 


12 . 

let big n = 


13. 

if n < 10 SS n > -10 { 


14 . 

15. 

println! (" et est un petit nombre, multiplions-le par dix"); 


16. 

// Cette expression renvoie un entier de type 'i32'. 


17 . 

10 * n 


18. 

} else { 


19. 

20. 

println! (" est un grand nombre, divisons-le par deux"); 


21. 

// Cette expression doit également renvoyer un entier de type 

k i32 ' . 

22 . 

n / 2 


23. 

// T0D0 A Essayez de supprimer cette expression en ajoutant un 

point-virgule. 

24 . 

} ; 


25. 

// A Ne pas oubliez de mettre un point-virgule ici! Toutes les 


26. 

27 . 

// assignations ('let') doivent se terminer par un point-virgule. 


28. 

println! ("{} -> {}", n, big n); 


29. 

} 
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7-2 - Le mot-clé loop 


Rust fournit le mot-clé loop pour créer une boucle infinie. 


Le mot-clé break peut être utilisé pour sortir de la boucle n'importe où tandis que le mot-clé continue peut être utilisé 
pour ignorer le reste de l'itération en cours et en débuter une nouvelle. 


1. fn 

main() { 


2 . 

let mut count = 0u32; 

3. 



4 . 

println! ("Comptons 

jusqu'à l'infini!"); 

5. 



6. 

// Boucle infinie. 


7 . 

loop { 


8. 

count += 1; 


9. 



10. 

if count == 3 

{ 

11. 

println! ( " 

trois" ); 

12 . 



13. 

// Ignore 

le reste de l'itération. 

14 . 

continue; 


15. 

} 


16. 



17 . 

println ! ("{}", 

count); 

18. 



19. 

if count == 5 

{ 

20. 

println! ( " 

Ok, ça suffit !" ); 

21. 



22 . 

// Sort de 

: la boucle. 

23. 

break; 


24 . 

} 


25. 

} 


26. } 




7-2-1 - L'imbrication et les labels 


Il est possible de sortir (i.e. break) ou de relancer (i.e. continue) l'itération d'une boucle à partir d'une autre boucle 
interne à cette dernière. Pour ce faire, les boucles concernées doivent être annotées avec un 'label et il devra être 
passé aux instructions break et/ou continue. 

1. # ! [allow(unreachable_code)] // permet de faire taire les avertissements 

2. // relatifs au code mort. 

3. 

4. fn main() { 

5. 'externe: loop { 

6. println! ("Entré dans la boucle annotée 'externe."); 

7 . 

8. 'interne: loop { 

9. println! ("Entré dans la boucle annotée 'interne."); 

10. 

11. // Cette instruction nous ferait simplement 

12. // sortir de la boucle 'interne. 

13. // break; 

14 . 

15. //On sort de la boucle 'externe 

16. //à partir de la boucle 'interne. 

17. break 'externe; 

18. } 

19. 

20. println! ("Cette ligne ne sera jamais exécutée."); 

21 . } 

22 . 

23. println! ("Sorti de la boucle annotée 'externe."); 

24. } 
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7-3 - La boucle while 


Le mot-clé while peut être utilisé pour itérer jusqu'à ce qu'une condition soit remplie. 


Écrivons les règles de l'infâme FizzBuzz en utilisant une boucle while : 


1. 

fn main() { 


2 . 

//Un compteur. 


3. 

let mut n = 1; 


4 . 

5. 

// Itère sur 'n' tant que sa valeur est strictement inférieure 

6. 

// à 101. 


7 . 

while n < 101 { 


8. 

if n % 15 == 0 

{ 

9. 

println! ( " 

fizzbuzz"); 

10. 

} else if n % 

3 == 0 { 

11. 

println! ( 

"fizz") ; 

12 . 

} else if n % 

5 == 0 { 

13. 

println! ( 

"buzz" ); 

14 . 

} else { 


15. 

println! ( 

"U", n); 

16. 

} 


17 . 

18. 

// Incrémente 

le compteur. 

19. 

n += 1; 


20. 

} 


21. 

■ } 



7-4 - La boucle for et les invervalles 


L'ensemble for in peut être utilisé pour itérer à l'aide d'une instance Iterator. L'une des manières les plus simples 
pour créer un itérateur est d'utiliser la notation d'intervalle (« range notation ») a..b. Soit un intervalle [a;b[ (comprend 
toutes les valeurs entre a (inclut) et b (exclut)). 


Écrivons les règles de FizzBuzz en utilisant la boucle for au lieu de while. 


1. 
2 . 
3. 
4 . 

5. 

6 . 
7 . 
8 . 
9. 
10 
11 
12 

13 

14 


fn main() { 

// 'n' prendra pour valeur: 1, 
for n in 1.. 101 { 

if n % 15 == 0 { 

println! ( "f izzbuzz " ); 

} else if n % 3 == 0 { 
println! ("fizz"); 

} else if n % 5 == 0 { 
println! ("buzz") ; 

} else { 

println !("{}", n); 

} 

} 

} 


2 , ..., 100 


au fil des itérations. 


Voir aussi 


Les itérateurs. 


7-5 - Le pattern matching 


Rust fournit le pattern matching via le mot-clé match, lequel peut être utilisé comme le mot-clé switch avec le langage 
C. 


1. fn main ( ) { 
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2. let number = 13; 

3. // TODO A Assignez différentes valeurs à 'number'. 

4 . 

5. println! ("Nature de number {}", number); 

6. match number { 

7. // Teste une seule valeur. 

8. 1 => println! ("Un!") , 

9. // Teste plusieurs valeurs. 

10. 2 | 3 | 5 | 7 | 11 => println !( "C' est un nombre premier."), 

11. // Teste l'intervalle [13;19]. 

12. 13... 19 => println! ("A teen"), 

13. // Couvre tous les autres cas. 

14. _ => println! ("Ain't spécial"), 

15. } 

16. 

17. let boolean = true; 

18. // L'analyse est également une expression. 

19. let binary = match boolean { 

20. // Les branches du match doivent couvrir tous les cas possibles. 

21. false => 0, 

22. true => 1, 

23. // TODO A Essayez de commenter l'une de ses branches. 

24. } ; 

25. 

26. println! ("{} -> {}", boolean, binary); 

27. } 


7-5-1 - La déstructuration 


Un bloc match peut décomposer des objets de différentes manières. 


7-5-1-1 - Les tuples 


Les tuples peuvent être déstructurés (entendez « décortiqués », « décomposés ») dans un bloc match comme suit : 


1. 

fn main() { 



2 . 

let pair = (0, -2); 



3. 

// TODO A Essayez de modifier les valeurs contenues par 


4 . 

5. 

// le tuple. 



6. 

println! ("Dites m'en plus 

à propos de {:?}", pair); 


7 . 

// match peut être utilisé pour déstructurer un tuple. 


8. 

match pair { 



9. 

// Déstructure 'y'. 



10. 

(0, y) => println! ( " 

Le premier élément est égal à '0' 


11. 

et 'y' égal à ' { : ? } 

", y), 


12 . 

(x, 0) => println! (" 

'x' est égal à '{:?}' et le dernier est égal à 'O' 1 

', x). 

13. 

=> println! ( " 

Peu importe ce qu’ils sont."). 


14 . 

Il L'underscore 

siginifie que vous ne souhaitez pas 


15. 

// assigner de valeurs à une variable, que vous souhaitez couvrir tous 

les 

16. 

Il autres cas. 



17 . 

} 



18. 

- } 




Voir aussi 
Les tuples. 


7-5-1-2 - Les énumérations 


Une énumération est déstructurée de la même manière : 

1. //On fait taire les avertissements (puisqu'on utilise 
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2 . 
3. 
4 . 

5. 

6 . 
7 . 
8 . 
9. 
10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 


// qu'une seule variante). 

#[allow(dead_code)] 
enum Color { 

// Identification implicite. 

Red, 

Blue, 

Green, 

// Ces variantes assignent plusieurs tuples sous différents noms: les modèles 
// de couleur. 

RGB(u32, u32, u32), 

HSV(u32, u32, u32), 

HSL(u32, u32, u32), 

CMY(u32, u32, u32), 

CMYK(u32, u32, u32, u32), 


} 


fn main() { 

let color = Color::RGB (122 , 17, 40); 

// TODO A Essayez de modifier les valeurs du tuple. 
println! ("De quelle couleur s'agit-il?"); 

// Une énumération peut être déstructurée en utilisant le pattern matching. 
match color { 

"La couleur rouge!"), 

"La couleur bleu!"), 

"La couleur vert!"), 


(' 


Color::Red => println 
Color::Blue => println 
Color::Green => println 
Color::RGB(r, g, b) => 

println! ("Rouge: {}, Vert: {}, et Bleu: {} 

Color::HSV(h, s, v) => 
println! ( 

Color: :HSL(h, 

println! ("Teinte: 

Color::CMY(c, m, y) => 
println! ("Cyan: {}, 

Color::CMYK(c, m, y, k) 
println! ("Cyan: {}, 

c, m, y, k) , 

// Inutile d'ajouter une branche "par défaut" car tous les 
// cas ont été couverts. 


"Teinte: {}, Saturation: {}, Valeur: {}!' 
s, 1) => 

{}, Saturation: {}, Lumière: {}! 

Magenta: {}, Jaune: {}!", c, r 
=> 

Magenta: {}, Jaune: {}, Noir: 


b) , 

h, s, v) , 
h, s, 1), 


, y), 
{} ! ", 


Voir aussi 

L'attribut allow(...), les modèles de couleur FR ou EN et les énumérations. 


7-5-1-3 - Les pointeurs et références 


À propos des pointeurs, la distinction doit être faite entre la déstructuration et le déréférencement puisque ce sont 
deux concepts différents utilisés différemment par rapport au langage C. 

• Le déréférencement utilise * ; 

• La déstructuration utilise &, ref, et ref mut. 


1. fn main ( ) { 

2. // Assigne une référence de type 'i32'. Le signifie qu'une 

3. // référence est assignée. 

4. // L'équivalent non-raccourci de cette assignation pourrait ressembler à ceci: 

5. // rust 

6. // let _reference: i32 = 4; 

7. // let reference: &i32 = &_reference; 

8 . 

9. let reference: &i32 = & 4; 

10 . 

11. match reference { 

12. // Lorsque 'reference' est comparé à '&val', la comparaison ressemble à ceci: 

13. // ' &i32' 

14. // '&val' <- 'val' est plus ou moins une représentation de 'reference'. 
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15 . // A Nous remarquons que si le est omis, la valeur devrait être 

16. // assignée à 'val'. 

17 . &val => println! ("On récupère une valeur via déstructuration: {:?}", val), 

18. } 

19. 

20 . // Pour éviter d'utiliser la référence, vous pouvez déréférencer 'reference' 

21 . // avant analyse (vous permettant d'opérer sur la valeur, si elle est mutable). 

22. match *reference { 

23 . val => println! ("On récupère la valeur déréférencée: {:?}", val), 

24. } 

25. 

26 . // Que se passe-t-il si vous ne créez pas une référence ? 'reference' 

27 . // était une référence parce que la r-value était une référence. Cette 

28 . // variable n'en est pas une parce que la r-value n'en est pas une. 

29. let _not_a_reference = 3; 

30. 

31 . // Rust fournit le mot-clé 'ref' dans ce but. Il modifie l'assignation 

32 . // de manière à créer une référence pour l'élément; cette référence est assignée. 

33. let ref _is_a_reference = 3; 

34. 

35 . // Bien entendu, en assignant deux valeurs sans références, ces dernières 

36 . // peuvent être récupérées à l'aide du mot-clé 'ref' et 'ref mut'. 

37. let value = 5; 

38. let mut mut_value = 6; 

39. 

40 . // On utilise le mot-clé 'ref' pour créer une référence. 

41. match value { 

42 . ref r => println! ("On récupère une référence de la valeur: {:?}", r), 

43. } 

44. 

45. // 'ref mut' s'utilise de la même manière. 

46. match mut_value { 

47. ref mut m => { 

48 . // On obtient une référence. Nous allons déréférencer 'm' avant 

49. //de pouvoir opérer. 

50. *m += 10; 

51. println !( "Nous incrémentons de 10. 'mut_value': {:?}", m) ; 

52. }, 

53. } 

54. } 


7-5-1-4 - Les structures 


Une structure peut également être déstructurée comme suit : 


1. 

fn main() { 



2 . 

T 

struct Foo { x: (u32, u32), y: 

u32 } 

U • 

4 . 

// Déstructure les membres de 

la structure. 

5. 

let foo = 

Foo { x: (1, 2), y: 

3 } ; 

6. 

n 

let Foo { 

x; (a, b) , y } = foo 

• 

/ . 

8. 

g 

println! ( 

"a = {}, b = {}, y = 

{} ", a, b, y); 

10. 

// Vous 

pouvez déstructurer les structures et renommer 

11. 

// leurs 

variables. L'ordre n 

'est pas important. 

12 . 




13. 

let Foo 

{ y: i, x: j } = foo; 


14 . 

println! 

("i = {:?}, j = {:?}" 

, i, j); 

15. 




16. 

// et vous pouvez aussi ignorer certaines variables: 

17 . 

let Foo 

{y, .. } = foo; 


18. 

println! 

II 


19. 




20. 

// Ceci 

donne une erreur: le 

pattern ne mentionne pas le champ 'x'. 

21. 

// let Foo { y } = foo; 


22 . 

■ } 




Voir aussi 
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Les structures, ref. 


7-5-2 - Les gardes 


Lorsque vous usez du pattern matching, un « garde » peut être ajouté dans chaque branche du match. 


1 . 

fn main() { 



2 . 

let pair = ( 2 , - 2 ); 



3. 

4 

// TODO A Essayez de modifier les valeurs de 'pair'. 


5. 

println! ("Dites m'en plus à propos de: 

{:?}", pair); 


6 . 

match pair { 



7 . 

(x, y) if x == y => println! ("Ils 

sont jumeaux !" ), 


8 . 

// La A condition if est un garde. 



9. 

(x, y) if x + y == 0 => println! (' 

'De l'antimatière 

, boom! ") , 

10 . 

(x, ) if x % 2 == 1 => println! i 

!"Le premier est 

étrange ..."), 

11 . 

=> println! ("Rien de spécial... 



12 . 

} 



13. 

. } 




Voir aussi 


Les tuples. 


7-5-3 - Assignation 


Accéder indirectement à une variable rend impossible sa réutilisation sans la réassigner, match fournit le symbole 
@ pour assigner des valeurs à des identificateurs : 


1 . 

// 

Une fonction 

'âge' qui renvoie un entier de type 'u32' 



2 . 

fn 

âge () -> 

u32 

{ 




3. 

4 . 

5. 

} 

15 






6 . 

fn 

main 0 { 






7 . 

8 . 


println 

! ("Dis-moi quel type de 

personne es-tu."); 



9. 


match âge() 

{ 




10 . 


0 


=> println! 

("Je ne suis pas encore 

né. 

je suppose. ") , 

11 , 


// 

Nous 

aurions pu 'match 

1 ... 12 directement mais 

il n'aurait pas 

12 . 


// 

été 

possible de connaître l'âge de l'enfant 



13. 


// 

À la 

place, nous assignons la valeur à 'n' 



14 . 


// 

pour 

la séquence de 1 

... 12. L'âge peut désormais 

être affiché. 

15. 


n 

@ 1 

. . . 12 => println! 

("Je suis un enfant de 

{ :?} 

ans ! " , n), 

16. 


n 

@ 13 

. . . 1 9 => println! 

("Je suis un adolescent 

de { 

: ?} ans ! " , n), 

17 . 


// 

Pas 

de limite. On renvoie le résultat. 



18. 


n 


=> println! 

("Je suis un adulte de 

{ :?} 

ans ! ", n), 

19. 


} 






20 . 

. } 








Voir aussi 
Les fonctions. 


7-6 - if let 


Pour certains cas, match peut être « lourd ». Par exemple : 

1. // Crée une valeur optionnelle de type 'Option<i32>'. 

2. let optional = Sortie (7); 

3. 
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4. match optional { 

5. Sortie (i) => { 

6 . println! ("Ceci est une très longue chaîne de caractères contenant un 

7. i); 

8. // * Deux niveaux d'indentations sont nécessaires alors 

9 . // que nous aurions pu simplement déstructurer 'i'. 

10 . }, 

11 . _ => {}, 

12. // A Nécessaire parce que 'match' est exhaustif. Cette branche vous 

13. // paraît-elle utile? 

14. } ; 


if let est plus adapté à ce genre de cas et permet la création de plusieurs branches en cas d'erreur : 


1. fn main() { 

2. // Toutes les variables sont de type 'Option<i32>'. 

3. let number = Some(7); 

4. let letter: Option<i32> = None; 

5. let emoticon: Option<i32> = None; 

6. 

7. // L'ensemble 'if let' se déroule de cette manière: 

8. // 'if let' déstructure 'number' et assigne sa valeur à 'i' et exécute 

9. //le bloc ('{}'). 

10. if let Some(i) = number { 

11. println !("{:?} a été trouvé!", i); 

12 . } 

13. 

14. // Si vous devez spécifier un cas d'erreur, utilisez un 'else': 

15. if let Some(i) = letter { 

16. println !("{:?} a été trouvé!", i); 

17. } else { 

18. // Déstructuration ratée. On exécute le 'else'. 

19. println! ("Aucun nombre n'a été trouvé. 

20. Cherchons une lettre!"); 

21 . } ; 

22 . 

23. // Fournit une condition alternative. 

24. let i_like_letters = false; 

25. 

26. if let Some(i) = emoticon { 

27. println !("{:?} a été trouvé!", i); 

28. // Déstructuration ratée. Passe à une condition 'else if' pour tester si 

29. //la condition alternative est vraie. 

30. } else if i_like_letters { 

31. println! ("Aucun nombre n'a été trouvé. 

32. Cherchons une lettre!"); 

33. } else { 

34. // La condition évaluée est fausse. Branche par défaut: 

35. println! ("Je n'aime pas les lettres. Cherchons une emoticône :) !"); 

36. } ; 

37. } 


Voir aussi 

Les énumérations, l'énumération Option et la RFC de if let. 


7-7 - while let 


Ayant un fonctionnement similaire à if let, while let peut alléger la syntaxe de match lorsqu'il n'est pas nécessaire de 
passer par le pattern matching. Voici une séquence qui incrémente i : 


1. Il Crée une valeur optionnelle de type 'Option<i32>'. 

2. let mut optional = Some(O); 

3. 

4. // On répète le test. 

5. loop { 

6 . match optional { 
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7 . 

// 

Si il est possible de déstructurer 'optional', 

8. 

// 

le bloc sera exécuté. 

9. 

Some(i) => { 

10. 


if i > 9 { 

11. 


println! ("Plus grand que 9, on quitte!"); 

12 . 


optional = None; 

13. 


} else { 

14 . 


println !("'i' est égal à '{:?}'. On réitère.", i) 

15. 


optional = Some(i + 1); 

16. 


} 

17 . 


// A Nécessite trois niveaux d'indentations. 

18. 

}, 


19. 

// 

On quitte la boucle si la déstructuration 

20. 

// 

a échoué: 

21. 


=> { break; } 

22 . 

7 / 

A Pourquoi cette instruction devrait être nécessaire ? 

23. 

// 

Il doit y avoir une solution plus adaptée! 

24 . 

25. } 

} 



En utilisant while let, cela rend la séquence plus lisible : 


I. 

2 . 
3. 

4 . 

5 . 

6 . 

7 . 

8 . 

9. 

10 . 

II . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 


fn main() { 

// Crée une valeur optionnelle de type 'Option<i32>' . 
let mut optional = Some(O); 

// Fonctionnement: "'while let' déstructure 'optional' pour assigner sa 
// à Some(i) puis exécute le bloc ('{}'). Sinon, on sort de la boucle." 
while let Some(i) = optional { 
if i > 9 { 

println! ("Plus grand que 9, on quitte!"); 
optional = None; 

} else { 

println !("'i' est égal à '{:?}'. On réitère.", i) ; 
optional = Some(i + 1); 

} 

// Moins explicite, il n'est plus nécessaire de gérer 
// le cas où la déstructuration échoue. 

} 

// A 'if let' permet d'ajouter des branches 'else'/'else if' 

// optionnelles, 'while let' ne le permet pas, en revanche. 

} 


valeur 


Voir aussi 

Les énumérations, l'énumération Option et la RFC de while let. 


8 - Les fonctions 


Les fonctions sont déclarées à l'aide du mot-clé fn. Leurs arguments sont typés, tout comme les variables, et, si la 
fonction renvoie une valeur, le type renvoyé doit être spécifié à la suite d'une flèche ->. 

La dernière expression se trouvant dans le corps de la fonction sera utilisée pour inférer le type de renvoi. Il est 
également possible d'utiliser l'instruction return pour effectuer un renvoi prématuré dans la fonction (peut être utilisé 
dans les boucles et les structures conditionnelles). 

Réécrivons les règles de FizzBuzz en utilisant les fonctions ! 


1. // Contrairement à C ou C++, l'ordre de déclaration des fonctions 

2. // n'est pas important. 

3 . fn main ( ) { 

4. // Nous pouvons appeler cette fonction ici et l'implémenter ailleurs. 

5. fizzbuzz_to (100); 

6 . } 

7. 
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8 . // Une fonction qui renvoie une valeur booléenne. 


9. 

fn 

10 . 


11 . 


12 . 


13. 


14 . 


15. 


16. 


17 . 

1 

18. 

// 

19. 

// 

20 . 

fn 

21 . 


22 . 


23. 


24 . 


25. 


26. 


27 . 


28. 


29. 


30. 

} 

31. 


32. 

// 

33. 

// 

34. 

fn 

35. 


36. 


37. 


38. 

} 


is_divisible_by(lhs: u32, rhs: u32) -> bool { 

// Comportement imprévisible, renvoi prématuré, 
if rhs == 0 { 

return false; 

} 


// C'est une expression, le mot-clé 'return' n'est pas nécessaire ici. 
lhs % rhs == 0 

Les fonctions qui n'ont pas de type de renvoi défini renvoient par défaut 
un tuple vide ()'. 

fizzbuzz(n: u32) -> () { 

if is_divisible_by(n, 15) { 

println! ( "fizzbuzz" ); 

} else if is_divisible_by(n, 3) { 

println! ("fizz"); 

} else if is_divisible_by(n, 5) { 

println! ("buzz") ; 

} else { 

println !("{}" , n); 

} 


Quand une fonction ne possède pas de type de renvoi, le tuple vide '()' 
peut être omis. 

fizzbuzz_to(n: u32) /* type de renvoi omis */ { 
for n in 1 ..n + 1 { 
fizzbuzz(n); 

} 


8-1 - Les méthodes 


Les méthodes sont des fonctions rattachées à des structures et objets. Ces méthodes ont un accès aux données de 
l'objet ainsi qu'à ses autres méthodes par le biais du mot-clé self. Les méthodes sont déclarées dans un bloc impl. 


1. struct Point { 

2 . x: f64, 

3. y: f64, 

4. } 

5. 

6 . // Toutes les méthodes de la structure 'Point' sont implémentées ici. 

7. impl Point { 


8 . 

9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 


// Ceci est une méthode statique. 

// Les méthodes statiques ne sont pas dépendantes des instances. 

// Il est courant d'utiliser les méthodes statiques comme constructeurs, 
fn origin() -> Point { 

Point { x: 0.0, y: 0.0 } 

} 

// Une autre méthode statique possédant 

// deux paramètres. 

fn new(x: f64, y: f64) -> Point { 

Point { x: x, y: y } 

} 

} 

struct Rectangle { 
pl: Point, 
p2: Point, 

} 

impl Rectangle { 

// Ceci est une méthode dépendante d'une instance (méthode d'instance). 
// '&self' est le sucre syntaxique de 'self: SSelf' où 'Self' est le 
// type de l'objet qui appelle les méthodes. En l'occurrence 
// 'Self' = 'Rectangle', 
fn area(Sself) -> f64 { 
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33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 

59. 

60. 
61. 
62. 

63. 

64. 

65. 

66 . 

67. 

68 . 

69. 

70. 

71. 
72 . 
73. 
74 . 

75. 

76. 
77 . 

78. 

79. 

80. 
81. 
82. 

83. 

84. 

85. 

86 . 

87. 

88 . 

89. 

90. 

91. 

92. 

93. 

94. 

95. 

96. 

97. 

98. 

99. 
100 
101 
102 

103 

104 


// 'self' donne accès aux champs de la structure via la notation pointée, 
let Point { x: xl, y: yl } = self.pl; 

let Point { x: x2, y: y2 } = self.p2; 

// 'abs' est une méthode renvoyant un réel de type f64 qui représente 
// la valeur absolue du primitif. 

( (xl - x 2 ) * (yl - y 2 ) ) .abs () 

} 

fn perimeter (Sself ) -> f64 { 

let Point { x: xl, y: yl } = self.pl; 

let Point { x: x2, y: y2 } = self.p2; 

2.0 * ( (xl - x 2 ) . abs ( ) + (yl - y 2 ).abs()) 

} 

// Cette méthode a besoin d'opérer sur une référence mutable 
//de l'instance courante ' &mut self'. 

//La syntaxe non-raccourcie est 'self: &mut Self', 
fn translate( &mut self, x: f64, y: f64) { 

self.pl.x += x; 
self.p 2 .x += x; 

self.pl. y += y; 
self.p 2 .y += y; 

} 

} 

// 'Pair' possède deux entiers alloués dans le tas. 
struct Pair(Box<i32>, Box<i32>); 

impi Pair { 

// Cette méthode "consomme" les ressources de l'instance courante. 

// 'self' est un sucre syntaxique de 'self: Self', 
fn destroy (self ) { 

// Déstructure 'self' (i.e. récupère les champs désirés), 
let Pair(first, second) = self; 

println! ("Destroying Pair({}, {})", first, second); 

// La mémoire occupée par 'first' et 'second' sera libérée 
// une fois que l'exécution de la méthode prendra fin. 

} 

} 

fn main() { 

let rectangle = Rectangle { 

// Les méthodes statiques sont appelées par le biais 
// d'une paire de deux points 

pl: Point::origin (), 

p2 : Point : :new(3. 0 , 4.0), 

} ; 


// Vous devez, en revanche, utiliser la notation pointée pour appeler 
// les méthodes d'instance. 

// Notez que le premier argument passé (implicitement) est 'Sself' 

// (i.e. 'rectangle.perimeter() === 'Rectangle::perimeter(^rectangle)'). 

println !( "Rectangle perimeter: {}", rectangle.perimeter()); 
println! ("Rectangle area: {}", rectangle.area()); 

let mut square = Rectangle { 
pl: Point::origin(), 
p2: Point::new(1. 0 , 1.0), 

} ; 


// Erreur! 'rectangle' est immuable alors que cette méthode 
// nécessite une référence mutable de l'objet. 

// rectangle.translate(1.0, 0.0); 

// TODO A Essayez de décommenter cette ligne. 

// C'est bon! Les objets mutables peuvent appeler les méthodes 
// "mutables". 
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105. square.translate(1.0, 1.0); 

106. 

107. let pair = Pair(Box::new(1), Box : : new (2 ) ) ; 

108. 

109. pair.destroy(); 

110. 

111 . // Erreur! L'appel de la méthode 'destroy' a consommé 

112. // l'instance 'pair'. 

113. // pair.destroy(); 

114 . // T0D0 A Essayez de décommenter cette ligne. 

115. } 


Définition : valeur absolue 


8-2 - Les closures 


Les closures en Rust, également appelées « lambdas », sont des fonctions qui peuvent capturer l'environnement qui 
les entoure. Par exemple, voici une closure qui capture la variable x : 


I val| val + x 


La syntaxe ainsi que les capacités des closures les rendent adéquates aux déclarations et utilisations à la volée. 
Appeler une closure se fait de la même manière qu'une fonction classique. En revanche, les types reçus en entrée 
(i.e. les types des paramètres passés) et le type de renvoi peuvent être inférés et les identificateurs des paramètres 
doivent être spécifiés. 

D'autres caractéristiques spécifiques aux closures : 

• L'utilisation du couple || plutôt que de () pour entourer les paramètres ; 

• La délimitation {} du corps de la closure optionnelle pour une seule expression (sinon obligatoire) ; 

• La capacité à capturer des variables appartenant au contexte dans lequel la closure est imbriquée. 


1 . 

fn main() { 


2 . 

// Incrémentation avec les closures et fonctions. 


3. 

fn function (i: i32) -> i32 { i + 1 } 


5. 

// Les closures sont anonymes, ici nous assignons leurs références. 

6 . 

// Les closures sont typées de la même manière qu'une fonction 

classique 

7 . 

// mais le typage est optionnel. Chaque version (raccourcie et 

non-raccourcie) 

8 . 

// est assignée à un identificateur approprié. 


9. 

let closure annotated = |i: 132| -> i32 { i + 1 }; 


10 

11 

12 

let closure inferred = 1 i 1 i + 1 ; 


let i = 1 ; 


13 

// Appelle la fonction et les closures. 


14 

println !( "function: {}", function(i)); 


15 

println! ("closure annotated: {}", closure annotated(i)); 


16 

println !( "closure inferred: {}", closure inferred(i)); 


17 

18 

// Une closure qui ne prend aucun argument et renvoie un 


19 

// entier de type 'i32'. 


20 

//Le type de renvoi est inféré. 


21 

let one = Il 1 ; 


22 

println !( "closure returning one: {}", one()); 


23 

24 

i 



8-2-1 - Capture 


Les closures sont naturellement flexibles et feront leur possible pour fonctionner sans typage explicite. Ceci permet 
à la capture de s'adapter au contexte : parfois en prenant possession des ressources, parfois seulement en les 
empruntant. Les closures peuvent capturer les variables : 
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• Par référence : &T ; 

• Par référence mutable : &mut T ; 

• Par valeur T. 

Par défaut, elles privilégient la capture par référence s'il n'est pas nécessaire de prendre possession des ressources. 


1. fn 

main() { 


2 . 

O 

use std::mem; 


■3 • 

4 . 

5. 

let color = "green"; 


6. 

// Une closure destinée à afficher la variable 'color' qui emprunte 


7 . 

// ('&') 'color' et stocke l'emprunt ainsi que la closure 


8. 

// dans la variable 'print'. Elle ('color') restera "empruntée" 


9. 

// jusqu'à ce que l'exécution de 'print' prend fin. 


10. 

//La macro println! ne fait qu'emprunter les ressources, cela 


11. 

// n'impose pas de contraintes supplémentaires pour la closure. 


12 . 

let print = Il println !("' color' : {}", color); 


13. 



14 . 

//On appelle la closure en empruntant 'color'. 


15. 

print(); 


16. 

print(); 


17 . 



18. 

let mut count = 0; 


19. 



20. 

// Une closure qui incrémente la variable 'count'. Cette dernière 


21. 

// pourrait être exploitée par référence '&mut count' ou valeur 


22 . 

// 'count', mais puisque '&mut count' est moins restrictif la capture 

23. 

// par référence mutable sera choisie. 


24 . 

// 


25. 

// La variable 'inc' est annotée comme 'mut' car une référence mutable 

26. 

// '&mut' est stockée à l'intérieur. 


27 . 

// Appeler la closure(du moins, dans ce contexte) modifie 


28. 

// son propre état et donc requiert un 'mut'. 


29. 



30. 

let mut inc = 11 { 


31. 

count += 1; 


32. 

println !("' count' : {}", count); 


33. 

} ; 


34. 



35. 

// Appelle la closure. 


36. 

inc () ; 


37. 

inc () ; 


38. 



39. 

// let reborrow = &mut count; 


40. 

// A TODO: Essayez de décommenter cette ligne. 


41. 



42 . 

//Un entier non-copiable. 


43. 

let movable = Box::new(3); 


44 . 



45. 

// 'mem::drop' prend possession de ses paramètres. 


46. 

//Un type pouvant être copié devrait être copié dans la closure, 


47 . 

// laissant la ressource originale intacte. Un type qui ne peut pas 


48. 

// être copié doit être déplacé et donc 'movable' appartiendra à la 

closure. 

49. 

let consume = 11 { 


50. 

println !("' movable' : {:?}", movable); 


51. 

mem::drop(movable); 


52. 

} ; 


53. 



54. 



// ' 

'consume' prend possession de la variable et ne peut donc être appelée 

qu'une seule fois. 

55. 

consume(); 


56. 

// consume ( ); 


57. 

// A TODO: Essayez de décommenter ce second appel. 


58. } 




Voir aussi 

Box et std::mem::drop. 
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8-2-2 - Les closures passées en paramètres 


Alors que Rust se charge de choisir, pour les closures, la manière de capturer les variables sans forcer le typage, 
lorsque c'est possible, cette ambiguïté n'est pas permise au sein des fonctions. Lorsqu'une closure est passée en 
paramètre à une fonction, le type de ses paramètres ainsi que celui de sa valeur de retour doivent être précisés en 
utilisant des traits. Dans l'ordre du plus restrictif au plus « laxiste » : 

1 Fn : La closure capture par référence (&T) ; 

2 FnMut : La closure capture par référence mutable (&mut T) ; 

3 FnOnce : La closure capture par valeur (T). 

En se fiant au contexte, le compilateur va capturer les variables en privilégiant le « régime » le moins restrictif possible. 

Par exemple, prenez un paramètre typé avec le trait FnOnce. Cela signifie que la closure peut capturer ses variables 
par référence &T, référence mutable &mut T, ou valeur T mais le compilateur reste encore le seul juge quant au 
régime à adopter, en fonction du contexte. 

C'est pourquoi si un transfert (move) est possible alors n'importe quel type d'emprunts devrait être possible, notez 
que l'inverse n'est pas vrai. Si le paramètre est typé Fn alors les captures par référence mutable &mutT ou par valeur 
T ne sont pas permises. 


Dans l'exemple suivant, essayez de modifier le type de capture (i.e. Fn, FnMut et FnOnce) pour voir ce qu'il se passe : 


1. // Une fonction qui prend une closure en paramètre et appelle cette dernière. 

2. fn apply<F>(f: F) where 

3. //La closure ne prend rien et ne renvoie rien. 

4. F : FnOnce() { 

5. // A TODO: Essayez de remplacer ce trait par 'Fn' ou 'FnMut'. 

6 . 

7 . f ( ) ; 

8 . } 

9. 

10. // Une fonction qui prend une closure en paramètre et renvoie un entier 

11. // de type 'i32'. 

12. fn apply_to_3<F>(f: F) -> i32 where 

13. // La closure prend en paramètre un '132' et renvoie 

14 . // un i32'. 

15. F: Fn(i32) -> i32 { 

16. 

17. f(3) 

18. } 

19. 

20. fn main() { 

21. use std::mem; 

22. 

23. let greeting = "hello"; 

24. // Un type qui ne peut pas être copié. 

25. // 'to_owned' crée une ressource dont 

26. // l'assignation 'farewell' sera responsable, à partir d'une ressource empruntée. 

27. let mut farewell = "goodbye" .to_owned(); 

28. 

29. // Capture deux variables: 'greeting' par référence et 

30. // 'farewell' par valeur. 

31. let diary = || { 

32. // 'greeting' est capturé par référence: requiert 'Fn'. 

33. println!("I said {}.", greeting); 

34. 

35. // Le fait de modifier 'farewell' rend obligatoire 

36. //la capture par référence mutable, le compilateur choisira 

37. // donc 'FnMut'. 

38. farewell.push_str ("!!!") ; 

39. println! ("Then I screamed {}.", farewell); 

40. println! ("Now I can sleep. zzzzz") ; 

41. 
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42 . // Appeler manuellement la fonction 'drop' nécessite 

43. // désormais de capturer par valeur 'farewell', le compilateur 

44. // choisira alors 'FnOnce'. 

45. mem:: drop(farewell); 

46. } ; 

47 . 

48 . // On appelle la fonction qui prend en paramètre la closure. 

49. apply(diary); 

50. 

51. // 'double' satisfait les conditions du trait soumis à 'apply_to_3'. 

52. let double = |x| 2 * x; 

53. 

54. println!("3 doubled: {}", apply_to_3(double)); 

55. } 

Voir aussi 


La fonction std::mem::drop et les traits Fn, FnMut et FnOnce. 


8-2-3 - Les types anonymes 


Les closures capturent succinctement les variables se trouvant dans les contextes qui les ont engendré. Cela a-t-il 
des conséquences ? Certainement. Nous remarquons qu'une fonction prête à recevoir une closure doit posséder un 
paramètre générique pour définir le « régime » de capture que la closure adoptera : 

1. // 'F' doit être générique. 

2. fn apply<F>(f: F) 

3. where 

4. F : FnOnce(), 

5. { 

6. f() ; 

7. } 

Quand une closure est définie, le compilateur crée implicitement une structure anonyme pour stocker les variables 
capturées par la closure. Cette structure implémentera également l'un des traits rencontrés précédemment : Fn, 
FnMut ou FnOnce. Ce type anonyme est assigné à la variable stockée jusqu'à ce que la closure soit appelée. 

Puisque le type créé implicitement est inconnu, son utilisation dans le corps d'une fonction nécessitera un paramètre 
générique. Cependant, un paramètre <T> dont le trait n'est pas précisé pourrait toujours être ambiguë et rejeté par 
le compilateur. Il est donc nécessaire de préciser quels services (i.e. Fn, FnMut ou FnOnce) il implémentera. 


1 . 

// 

'F' doit implémenter 'Fn' pour une closure qui i 

ne prend aucun 

2 . 

// 

argument et ne renvoie rien - exactement ce qui 

est nécessaire 

3. 

// 

pour 'print'. 


4 . 

fn 

apply<F>(f: F) where 


5. 


F : Fn ( ) { 


6 . 

7 . 

8 . 

} 

f 0 ; 


9. 

fn 

main() { 


10 . 


let x = 7; 


11 . 




12 . 


// Capture la variable 'x' dans une structure 

anonyme 

13. 


// et implémente 'Fn' pour cette dernière. On 

stocke dans 'print'. 

14 , 


let print = l| println! ( " {} " , x); 


15. 




16. 


apply(print); 


17 . 

. 1 




Voir aussi 


Une analyse complète des closures, Fn, FnMut et FnOnce. 
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8-2-4 - Fonctions passées en paramètres 


Les closures peuvent être soumises en entrée aux fonctions, mais vous pourriez vous demander si nous pouvons 
faire de même avec d'autres fonctions. C'est le cas ! Si vous déclarez une fonction qui prend une closure en paramètre 
alors n'importe quelle fonction implémentant les traits requis peut être passée en paramètre. 


— Il 

On déclare 

une fonction qui 

prend l'argument générique 'F' 


2. Il 

délimité par le trait 'Fn' « 

et appelle la fonction (ou closure). 


3. fn 

call me<F: 

Fn ( ) > ( f : F) { 



4 . 

5. } 

6 . 

f 0 ; 




7. Il 

On déclare 

une fonction qui 

satisfait la délimitation (hériter de 

'Fn') . 

8 . fn 

function ( ) 

{ 



9. 

println! ( ' 

'I'm a function!" 

) ; 


10 . } 





11 . 





12. fn main() { 




13. 

// On déclare une closure 

qui satisfait la délimitation (hériter 

de ' Fn') . 

14 . 

let closure = 11 println! 

("I'm a closure!"); 


15. 





16. 

call me(closure); 



17 . 

call me(function); 



18. } 






Voir aussi 

Fn, FnMut et FnOnce. 


8-2-5 - Renvoyer une closure 


Les closures peuvent être passées en paramètre à une fonction, donc les renvoyer devrait être possible. Cependant, 
renvoyer un « type » de closure est problématique car, actuellement, Rust ne supporte le renvoi que de types concrets 
(i.e. non-génériques). Le type anonyme d'une closure est, par définition, inconnu donc le renvoi d'une closure ne peut 
être fait qu'en rendant son type concret. 

Les traits destinés à valider le renvoi d'une closure sont quelque peu différents : 

• Fn : pas de changements pour ce trait ; 

• FnMut : pas de changements pour ce trait ; 

• FnOnce : Différentes choses entrent en jeu ici, donc le type FnBox doit être utilisé à la place de FnOnce. 

Notez toutefois que FnBox est taggé instable et que des modifications pourraient être apportées dans le 
futur. 

En dehors de cela, le mot-clé move doit être utilisé, indiquant que toutes les captures se feront par valeur pour la 
closure courante. Il est nécessaire d'utiliser move car aucune capture par référence ne pourrait être libérée aussitôt 
la fonction terminée, laissant des références invalides dans la closure. 

1. fn create_fn() -> Box<Fn()> { 

2. let text = "Fn".to_owned() ; 

3. 

4. Box::new (move || println! ( "This is a: {}", text)) 

5. } 

6 . 

7. fn create_fnmut() -> Box<FnMut()> { 

8 . let text = ” FnMut " .to_owned(); 

9. 

10. Box::new (move || println !( "This is a: {}", text)) 

11 . } 

12 . 

13. fn main() { 
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14. let fn_plain = create_fn(); 

15. let mut fn_mut = create_fnmut(); 

16. 

17. fn_plain(); 

18. fn_mut(); 

19. } 


Voir aussi 

Box, Fn, FnMut et la généricité. 


8-2-6 - Exemples de la bibliothèque standard 


Cette section contient quelques exemples d'utilisation de closures avec des outils fournis par la bibliothèque standard. 


8-2-6-1 - lterator::any 


lterator::any est une fonction qui, lorsqu'un itérateur est passé en paramètre, renvoie true si au moins un élément 
satisfait le prédicat, autrement false. Voici sa signature : 


1. pub trait Iterator { 


2 . 

//Le type sur lequel on va 

itérer. 

3. 

4 _ 

type Item; 


5. 

// 'any' prend en paramètre 

une référence mutable '&mut self' de 

6 . 

// l'instance courante qui 

sera empruntée et modifiée, mais pas consommée 

7 . 

// (possédée). 


8. 

fn any<F>(&mut self, f: F) 

-> bool 

9. 

where 


10 . 

F: FnMut(Self::Item) - 

> bool. 

11 . 

{ 


12 . 

true 


13. 

} 


14. ; 

! 



1 . fn main() { 

2. let vecl = vec![l, 2, 3] ; 

3. let vec2 = vec![4, 5, 6 ]; 

4 . 

5. // 'iter()', pour les vecteurs, fournit la référence de chaque 

6 . // élément '&i32'. 

7. println! ( "2 in vecl : {}" , vecl.iter () . any ( | &x | x == 2 )); 

8 . // 'into_iter()', pour les vecteurs, fournit la valeur de chaque élément 'i32'. 

9. // L'itérateur est consommé. 

10 . println ! ("2 in vec 2 : {}", vec 2 .into_iter().any(| x| x == 2 )); 

11. let arrayl = [1, 2, 3] ; 

12. let array2 = [4, 5, 6 ]; 

13. 

14 . // 'iter()' fournit la référence de chaque élément du tableau 'Si32'. 

15. println! ("2 in arrayl: {}", arrayl.iter() ,any(|&x| x == 2)); 

16 . // 'into_iter()' fournit, exceptionnellement, la référence de chaque élément 

17 . // du tableau 'Si32' (le type i32 implémente les traits requis). 

18. println ! ("2 in array 2 : {}", array 2 .into_iter().any(|&x| x == 2 )); 

19. } 


Voir aussi 

std::iter::lterator::any. 


8-2-6-2 - Iterator: :find 


lterator::find est une fonction qui renvoie le premier élément correspondant au prédicat. 
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1. pub trait Iterator { 

2. //Le type sur lequel on va itérer. 

3. type Item; 

4 . 

5. // 'find' prend en paramètre une référence mutable de l'instance courante 

6. // '&mut self'. Elle sera donc empruntée et modifiée, mais pas consommée. 

7. fn find<P>(Smut self, predicate: P) -> Option<Self : :Item> 

8 . where 

9. P: FnMut( SSelf : : Item) -> bool, 

10 . { 

11. None 

12 . } 

13. } 


I . fn main() { 

2 . let vecl = vec! [ 1 , 2 , 3] ; 

3. let vec2 = vec! [4, 5, 6 ] ; 

4 . 

5. // 'iter()' fournit la référence de chaque élément 'Si32' du vecteur. 

6 . let mut iter = vecl . iter (); 

7. // 'into_iter() fournit la valeur de chaque élément du vecteur. 

8 . let mut into_iter = vec 2 .into_iter (); 

9. 

10. // Référence fournie par 'iter': 'SSi32'. On déstructure la référence 

II. // de la référence pour obtenir l'entier 'i32'. 

12. println! ( "Find 2 in vecl: {:?}", iter .find (|&&x| x == 2)); 

13. // Référence fournie par 'into_iter': '&i32'. On déstructure la référence 

14. // pour obtenir l'entier 'i32'. 

15. println !( "Find 2 in vec2 : {:?}", into_iter . find (I &x| x == 2)); 

16. 

17. let arrayl = [1, 2, 3] ; 

18. let array2 = [4, 5, 6 ] ; 

19. 

20. // 'iter()' fournit la référence de chaque élément du tableau '&i32'. 

21. println !( "Find 2 in arrayl: {:?}", arrayl.iter () ,find(|SSx| x == 2)); 

22. // 'into_iter()' fournit, exceptionnellement, la référence de chaque élément 

23 . // du tableau '&i32' (le type i32 implémente les traits requis) . 

24. println !( "Find 2 in array2 : {:?}", array2.into_iter () .find (|SSx| x == 2)); 

25. } 


Voir aussi 

std: : iter: :lterator: :find . 


8-3 - Les fonctions d'ordre supérieur 


Rust supporte les fonctions d'ordre supérieur (HOF). Ces fonctions prennent en paramètre une ou plusieurs 
fonctions et renvoie une autre fonction. Ce sont les HOF ainsi que les « itérateurs laxistes » qui donnent cet aspect 
fonctionnel à Rust. 


1. fn is_odd(n: u32) -> bool { 

2 . n % 2 == 1 

3. } 

4 . 

5. fn main() { 

6 . println! ("Find the sum of ail the squared odd numbers under 1000"); 

7. let upper = 1000; 

8 . 

9. // Approche impérative. 

10. // On déclare un accumulateur. 

11 . let mut acc = 0 ; // 0 , 1 , 2 , ... ~ 

12 . for n in 0 .. { 

13. // Le carré du nombre. 

14. let n_squared = n * n; 

15. 

16. if n_squared >= upper { 

17 . // On sort de la boucle si le carré de 'n_squared' 
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18. 

19. 

20 . 

21 . 

22 . 

23. 

24 . 

25. 

26. 

27 . 

28. 

29. 

30. 

upper) 

31. 

32. 

33. 

34. } 


// dépasse la limite imposée par 'upper'. 
break; 

} else if is_odd(n_squared) { 

// On accumule le carré de 'n_squared' si c’est impair, 
acc += n_squared; 

} 

} 

println! ("impérative style: {}", acc) ; 

// Approche fonctionnelle. 

let sum_of_squared_odd_numbers: u32 = 

(0..).map(|n| n * n) // On calcule le carré de chaque nombre. 

.take_while(|&n| n < 

// On vérifie que le carré se trouve toujours sous la limite de 'upper'. 

. filter(|&n| is_odd(n)) // On récupère le nombre si il est impair. 

.fold(0, Isum, il sum + i); //On accumule le carré du nombre impair, 
println! ("functional style: {}", sum_of_squared_odd_numbers); 


L'énumération Option et le trait Iterator implémentent leur lot d'HOF. 


9 - Les modules 


Rust fournit un puissant système de modules qui peut être utilisé pour hiérarchiser et diviser logiquement le code en 
plusieurs sous-modules et gérer la visibilité des ressources (publiques ou privées). 


Un module est un ensemble d'éléments (e.g. ensemble de fonctions, de structures, de traits, de blocs « impi » et 
même d'autres modules). 


9-1 - La visibilité 


Par défaut, tout ce qui peut être contenu dans un module est privé. Nous pouvons remédier à cela en utilisant le mot- 
clé pub. Seuls les items publics d'un module peuvent être sollicités en dehors du contexte du module. 


1. //Un module nommé 'my . 

2 . mod my { 

3. // Les items se trouvant dans le module sont privés, par défaut. 

4. fn private_function() { 

5. println! ("called 'my :: private_function ()'") ; 

6 . } 

7 . 


8 . 

9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 


// Utilisez le mot-clé 'pub' pour modifier la visibilité par défaut, 
pub fn function() { 

println! ( "called 'my : : function () '" ); 

} 


// Des items se trouvant dans le même module peuvent se solliciter 
// entre-eux, même lorsqu'ils sont privés, 
pub fn indirect_access() { 

print !( "called 'my : : indirect_access() ' , that\n> "); 
private_function(); 

} 

// Les modules peuvent également être imbriqués, 
pub mod nested { 

pub fn functionf) { 

println! ("called 'my : : nested : : function ( ) ' ") ; 

} 

#[allow(dead_code) ] 
fn private_function() { 

println! ("called 'my : : nested : : private_function ( ) ' " ); 

1 

} 

// Les modules imbriqués suivent les mêmes règles vis-à-vis de la 
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32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 

59. 

60. 
61. 
62. 

63. 

64. 

65. 

66 . 

67. 

68 . 

69. 

70. 

71. 
72 . 


// visibilité, 
mod private_nested { 

# [allow(dead_code) ] 
pub fn function() { 

println! ("called ’my: :private_nested::function() '" ); 


} 

fn function() { 

println! ("called ' f unction () ' " ) ; 

} 


fn main() { 

// Les noms des modules rattachés à une ressource peuvent être explicités 
// pour supprimer toute ambiguité entre deux ressources possédant le même 
// nom. 
function(); 
my: :function(); 

// Les items publics, y compris ceux qui se trouvent dans les modules 
// imbriqués, peuvent être sollicités en dehors du module parent, 
my: :indirect_access(); 
my:rnested::function(); 

// Les items privés d'un module ne peuvent pas être directement sollicités, 
// même si ils sont imbriqués dans un module public: 

// Erreur! 'private_function' est privée. 

// my::private_function(); 

// TODO A Essayez de décommenter cette ligne. 

// Erreur! 'private_function' est privée. 

// my::nested::private_function(); 

// TODO A Essayez de décommenter cette ligne. 

// Erreur! 'private_nested' est un module privé. 

// my::private_nested::function(); 

// TODO A Essayez de décommenter cette ligne. 


9-2 - La visibilité des structures 


Les structures disposent d'un niveau supplémentaire de visibilité dédié à leurs champs. Comme pour les autres 
ressources, les champs d'une structure sont privés par défaut, mais peuvent être rendus publics en utilisant, encore 
une fois, le mot-clé pub. La visibilité des champs ne s'applique, bien entendu, que lorsqu'une structure est sollicitée 
en dehors du module où elle a été déclarée et a pour but de masquer les données (encapsulation). 


1. mod my { 

2. // Une structure publique avec un champ public générique de type 'T'. 

3. pub struct WhiteBox<T> { 

4. pub contents: T, 

5. } 

6 . 

7. // Une structure publique avec un champ privé générique de type 'T'. 

8. #[allow(dead_code)] 

9. pub struct BlackBox<T> { 

10. contents: T, 

11 . } 

12 . 

13. impl<T> BlackBox<T> { 

14. // Constructeur public. 

15. pub fn new(contents : T) -> BlackBox<T> { 

16. BlackBox { 

17. contents: contents, 

18. } 

19. } 

20 . } 
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21 . } 

22 . 

23. fn main() { 

24. // Les structures publiques possédant des champs publics 

25. // peuvent être instanciées avec les séparateurs '{}'• 

26. let white_box = my::WhiteBox { contents: "public information" }; 

27. 

28. // et leurs champs peuvent être sollicités normalement. 

29. println! ( "The white box contains: {}", white_box.contents); 

30. 

31. // Les structures publiques composées de champs privés ne peuvent pas être 

32. // instanciées de manière "classique" (i.e. en précisant le nom des champs). 

33. // Erreur! 'BlackBox' possèdent des champs privés. 

34. // let black_box = my::BlackBox { contents: "classified information" }; 

35. // TODO A Essayez de décommenter cette ligne. 

36. 

37. // En revanche, elles peuvent être créées avec un constructeur public. 

38. let _black_box = my::BlackBox::new( "classified information"); 

39. 

40. // Les champs privés d'une structure publique ne peuvent pas être 

41. // sollicités directement. 

42. // Erreur! Le champ 'contents' est privé. 

43. // println!("The black box contains: {}", _black_box.contents); 

44. // TODO A Essayez de décommenter cette ligne. 

45. } 


Voir aussi 

La généricité et les méthodes. 


9-3 - La dédaration use 


La déclaration use peut être utilisée pour assigner un chemin à un nouveau nom, pour y accéder plus rapidement. 


1. // Assigne le chemin 'deeply: :nested::function' à l'identificateur 

2 . // 'other_function'. 

3. use deeply::nested::function as other_function; 

4 . 

5. fn function () { 

6 . println! ("called ' function ()'") ; 

7 . } 

8 . 

9. mod deeply { 

10 . pub mod nested { 

11 . pub fn function() { 

12 . println !( "called ' deeply :: nested :: function ()'" ) 

13. } 

14. } 

15. } 

16. 

17. fn main ( ) { 

18. // Accès moins verbeux à 'deeply::nested::function'. 

19. other_function(); 

20 . 

21. println! ("Entering block"); 

22 . { 

23. // Ceci est équivalent à 'use deeply::nested::function as function'. 

24. // La nouvelle assignation 'function()' prendra le pas 

25. // sur 'deeply::nested::function()'. 

26. use deeply:tnested::function; 

27 . function(); 

28. 

29. // Les assignations 'use' ne sont disponibles que dans le contexte 

30. // où elles ont vu le jour. Dans ce cas, où 'functionO ' occulte 

31. // le chemin de base, ce "shadowing" n'est effectif que dans ce bloc. 

32. println! ("Leaving block"); 

33. } 

34. 
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35 . function ( ) ; 

36. } 


9-4 - Les mot-clés super et self 


Les mot-clés super et self peuvent être utilisés pour lever l'ambiguïté sur la provenance d'une ressource et éviter de 
réécrire leur chemin respectif(i.e. le chemin de la ressource). 


1 . 

fn function() { 

2 . 

println! ( "called ' function ()'" ); 

3. 

4 . 

} 


5. 

mod cool 

{ 

6 . 

pub 

fn function () { 

7 . 


println! ( "called ' cool : : function () ' " ) ; 

8 . 

9. 

} 

} 


10 



11 

mod my 

{ 

12 

fn 

function () { 

13 


println! ( "called ' my : : function () '" ); 

14 

} 


15 



16 

mod 

cool { 

17 


pub fn function() { 

18 


println! ( "called 'my : : cool : : function () ' " ) ; 

19 


} 

20 

} 


21 



22 

pub 

fn indirect call() { 

23 


// Appelons toutes les fonctions nommées 'fonction' depuis ce 

24 


// contexte! 

25 


print! ("called 'my:: indirect call()', that\n> "); 

26 



27 


// Le mot-clé 'self' fait référence au module courant (en l'occurrence 

28 


// 'my'). Appeler ' self :: function () ou 'functionO' revient exactement 

29 


// au même, puisqu'ils font tous deux référence à la même fonction. 

30 


self : :function(); 

31 


function(); 

32 



33 


// Vous pouvez également utiliser 'self' pour accéder à un autre module 

34 


// imbriqué dans 'my'. 

35 


self : :cool: :function(); 

36 



37 


// Le mot-clé 'super' fait référence au contexte parent (en-dehors du 

38 


// module 'my', pour cet exemple). 

39 


super : :function(); 

40 



41 


// Si vous ne spécifiez aucun des deux mot-clés, le compilateur 

42 


// comprendra que vous essayez d'utiliser une ressource se trouvant 

43 


// dans le contexte de la crate. 

44 


// On va donc assigner un nouvel identificateur à 'cool::function () se 

45 


// trouvant dans le contexte de la crate. 

46 


// Le contexte de la crate représente tout ce qui se trouve en-dehors des modules. 

47 


{ 

48 


use cool::function as root function; 

49 


root function(); 

50 


} 

51 

} 


52 

} 


53 



54 

fn main() { 

55 

my : 

: indirect call(); 

56 

} 
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9-5 - La hiérarchie des fichiers 


Il est possible de transformer nos modules en un ensemble de fichiers et de répertoires. Recréons l'exemple utilisé 
pour illustrer le concept de la visibilité en un ensemble de fichiers : 

1 . $ tree . 

2 . . 

3 . | — my 

4. | |-- inaccessible.rs 

5.1 |-- mod.rs 

6 . I nested.rs 

7. -- split.rs 


1. // Dans le fichier my/mod.rs 

2. //De la même manière 'mod inaccessible' et 'mod nested' vont essayer de localiser 

3. // les fichiers 'nested.rs' et 'inaccessible .rs' pour récupérer et ajouter leur contenu 

4. // dans leur module respectif. 

5. mod inaccessible; 

6 . pub mod nested; 

7 . 

8 . pub fn function() { 

9. println! ( "called 'my : : function () '" ); 

10 . } 

11 . 

12 . fn private_function() { 

13. println! ("called 'my : :private_function ()'" ); 

14. } 

15. 

16. pub fn indirect_access() { 

17. print !( "called 'my ; : indirect_access () ', that\n> "); 

18. 

19. private_function(); 

20 . } 


1 . 

// Dans le fichier my/nested.rs 

2 . 

pub fn function() { 


3. 

4 . 

println! ("called 'my: 

} 

: nested: : function ()'") ; 

5. 

6 . 

#[allow(dead code)] 


7 . 

fn private function() { 


8 . 

9. 

println! ("called 'my: 

} 

: nested: : private function ()'" ); 


1. // Dans le fichier my/inaccessible.rs 

2 . #[allow(dead_code)] 

3. pub fn public_function() { 

4. println! ("called 'my :: inaccessible :: public_function ()'") ; 

5. } 

1 . $ rustc split.rs && ./split 

2 . called 'my :: function () 

3. called ' function ()' 

4. called 'my : : indirect_access () , that 

5. > called 'my : :private_function () 

6 . called my:znested:: function () 


10 - Les crates 


Une crate est une unité de compilation en Rust. Lorsque rustc some_file.rs est appelé, some_file.rs est considéré 
comme étant un «fichier paquet» (i.e. un fichier fédérant les autres). Si some_file.rs possède plusieurs modules en 
son sein, chacun d'entre eux verra son contenu fusionné dans ce paquet avant que la compilation n'ait lieu. Autrement 
dit, les modules ne sont pas compilés individuellement, mais en tant que paquet, en tant qu'ensemble de ressources. 
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Une crate peut être compilée en tant qu'exécutable ou bibliothèque. Par défaut, rustc produira un exécutable mais 
cela peut être modifié en passant le flag --crate-type au compilateur. 


10-1 - Créer une bibliothèque 


Commençons par créer une bibliothèque dont nous nous servirons ensuite pour l'importer dans une autre crate. 


1 . 

// 

Dans le fichier rary.rs 



2 . 

pub 

' fn public function() { 



3. 


println! ("called rary's 

'public function()' 

' " ) ; 

4 . 

} 




5. 





6 . 

fn 

private function() { 



7 . 


println !( "called rary's 

'private function() 

' " ) ; 

8 . 

9. 

1 




10 . 

. pub fn indirect accessO { 



11 . 


print !( "called rary's 

indirect accessO', 

that\n> "); 

12 . 





13. 


private function(); 



14 . 

. } 





$ rustc --crate-type=lib rary.rs 
$ ls lib* 
library.rlib 


Les bibliothèques sont préfixées par la séquence « lib » et possèdent, par défaut, le nom du fichier utilisé pour créer 
la crate (en l'occurrence rary.rs). Ce comportement peut, bien entendu, être modifié en utilisant l'attribut crate_name. 


10-2 - La déclaration extern crate 


Pour importer une crate à cette nouvelle bibliothèque, il vous faudra utiliser la déclaration extern crate. Cette 
déclaration a aussi pour effet d'importer toutes les ressources sous un même module, possédant le même nom que la 
bibliothèque. Les règles régissant la visibilité des ressources s'appliquent également aux modules des bibliothèques 
importées. 



11 - Les attributs 


Un attribut est une méta-donnée pouvant être appliqué à plusieurs sortes d'éléments (e.g. modules, crates). Ces 
méta-données peuvent être utilisées pour : 


-49- 

Le contenu de cet article est rédigé par Rust Core Team et est mis à disposition selon les termes de la Licence Creative Commons Attribution 3.0 non transposé. Les logos Developpez.com, 
en-tête, pied de page, css, et look & feel de l'article sont Copyright ® 2013 Developpez.com. 

http://rust.developpez.com/tutoriels/rust-par-l-exemple/ 














> 


Devcieppcx.com 


Rust par l'exemple par Rust Core Team 


• Ajouter des conditions à la compilation; 

• Établir le nom, la version et le type (i.e. exécutable ou bibliothèque) d'une crate ; 

• Désactiver certains avertissements de l'analyse; 

• Activer des fonctionnalités (e.g. macros, imports globaux) propres au compilateur ; 

• Importer une bibliothèque d'un autre langage (i.e. FFI); 

• Signaler des fonctions utilisées pour exécuter des tests unitaires ; 

• Signaler des fonctions utilisées dans le cadre d'un benchmark. 

Quand les attributs sont appliqués à une crate toute entière, leur syntaxe est la suivante #![crate_attribute]. Lorsqu'ils 
sont appliqués à un module ou un autre élément, la syntaxe est la suivante #[item_attribute](vous noterez la 
disparation du point d'exclamation). 

Les attributs peuvent prendre des arguments sous différentes syntaxes : 

• #[attribute = "value"] ; 

• #[attribute(key = "value")] ; 

• #[attribute(value)]. 


11-1 - L'avertissement dead code 


La compilateur fournit la lint dead_code qui vous avertira lorsqu'une instruction (ou une fonction) ne sera jamais 
exécutée. Un attribut peut être utilisé pour désactiver cette lint. 


1 . 

9 

fn used function() {} 



Z . 

3. 

// L'attribut '#[allow(dead code)]' 

désactive 

la lint 'dead code'. 

4 . 

#[allow(dead code)] 



5. 

C 

fn unused functionf) {} 



O . 

7 . 

fn noisy unused function() {} 



8. 

g _ 

// FIXME A Ajoutez un attribut pour 

supprimer 

1 'avertissement. 

10. 

. fn main() { 



11 

used functionf); 



12 . 

. } 




Gardez tout de même à l'esprit que, dans un programme destiné à être mis en production, il est préférable de 
supprimer le code mort. Ici, le code mort sera conservé simplement pour l'exemple. 


11-2 - Méta-données relatives aux crates 


L'attribut crate_type peut être utilisé pour renseigner au compilateur le type de la crate (i.e. exécutable ou 
bibliothèque(et quel type de bibliothèque)) et l'attribut crate_name est utilisé pour renseigner le nom de la crate. 


1. // Dans le fichier lib.rs 

2. // Cette crate est une bibliothèque. 

3. # ! [crate_type = "lib"] 

4. // Cette bibliothèque est nommée "rary". 

5. # ! [cratename = "rary"] 

6 . 

7. pub fn public_function() { 

8 . println ! ( "called rary's ' public_function ( )' " ); 

9. } 

10 . 

11 . fn private_function() { 

12. println ! ("called rary's ' private_function ()'") ; 

13. } 

14 . 

15. pub fn indirect_access() { 

16. print ! ("called rary's ' indirect_access ()’, that\n> "); 

17 . 
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18. private_function(); 

19. } 


Lorsque l'attribut crate_type est utilisé vous n'avez, bien entendu, plus besoin de passer le flag --crate-type à rustc. 

$ rustc lib.rs 
$ ls lib* 
library.rlib 


11-3 - L'attribut cfg 


La compilation conditionnelle est possible grâce à deux opérateurs : 

1 L'attribut cfg : #[cfg(...)] ; 

2 La macro cfg! : cfg!(...) en tant qu'expression booléenne. 

Tous deux possèdent la même syntaxe : 


1. // Cette fonction ne sera compilée que sur des distributions Linux. 

2. # [cfg(target_os = "linux")] 

3. fn are_you_on_linux() { 

4. println! ("You are running linux!") 

5. } 

6. 

7. //Et cette fonction sera compilée seulement sur des plateformes qui ne sont 

8. // *pas* des distributions Linux. 

9. # [cfg(not(target_os = "linux"))] 

10. fn are_you_on_linux() { 

11. println! ("You are *not* running linux!") 

12 . } 

13. 

14. fn main ( ) { 

15. are_you_on_linux(); 

16. 

17. println! ("Are you sure?") ; 

18. if cfg! (target_os = "linux") { 

19. println !( "Yes. It's definitely linux!"); 

20. } else { 

21. println !( "Yes. It's definitely *not* linux!"); 

22. } 

23. } 


Voir aussi 

La référence de l'attribut cfg, std::cfg! et les macros. 


11-3-1 - Condition personnalisée 


Certaines conditions (e.g. target_os) sont fournies par rustc. Il est toutefois possible de passer des conditions 
personnalisées à rustc en utilisant le flag --cfg. 

1. // Dans le fichier custom.rs 

2. #[cfg(some_condition)] 

3. fn conditional_function() { 

4. println! ("condition met!") 

5. } 

6 . 

7 . fn main ( ) { 

8. conditional_function(); 

9. } 
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Sans le flag personnalisé : 

$ rustc custom.rs && ./custom 

No such file or directory (os error 2) 


Avec le flag personnalisé : 

$ rustc --cfg some_condition custom.rs && ./custom 
condition met! 


12 - La généricité 


Comme son nom l'indique, cette section abordera les types et fonctionnalités génériques. La généricité peut être 
très utile pour réduire les répétitions au sein du code dans de nombreux cas, mais vous demandera, en échange, 
d'apporter quelques précisions supplémentaires à propos de la syntaxe. Notez également que rendre une ressource 
générique signifie que n'importe quelle ressource sera traitée de la même manière, il est nécessaire de savoir quels 
types de ressources peuvent être réellement traités, dans les cas où il est nécessaire de le spécifier. 

La généricité est principalement utilisée pour rendre générique un, ou plusieurs, paramètre passé à une fonction. Par 
convention, un paramètre générique doit avoir un identificateur respectant la convention de nommage CamelCase et 
être déclaré entre un chevron ouvrant (<) et un chevron fermant(>) : <Aaa, Bbb, ...>, qui est souvent représenté par le 
paramètre <T>. En déclarant un paramètre générique de type <T>, on accepte de recevoir un, ou plusieurs, paramètre 
de ce type. Tout paramètre déclaré comme générique est générique, tout le reste est concret (non-générique). 

Par exemple, voici une fonction générique nommée foo qui prend un paramètre de type T (de n'importe quel type, 
donc) : 


fn foo<T>(p: T) { ... } 


1. //A est un type concret. 

2. struct A; 

3. 

4. // Lorsque nous déclarons 'Single', la première occurrence de 'A' n'est 

5. // pas précédée du type générique '<A>'. Le type 'Single' et 'A' sont donc 

6. // concrets. 

7. struct Single(A); 

8. // A Voici la première occurrence du type 'A'. 

9. 

10. // En revanche, ici, '<T>' précède la première occurrence 'T', donc le type 

11. // 'SingleGen' est générique. Puisque le type 'T' est générique, cela pourrait être 

12. // "n’importe quoi", y compris le type concret 'A' déclaré au début du fichier. 

13. struct SingleGen<T>(T); 

14 . 

15. fn main() { 

16. // 'Single' est un type concret et prend explicitement un paramètre 

17. //de type 'A'. 

18. let _s = Single(A); 

19. 

20 . // On créé une variable nommée '_char' de type 'SingleGen<char>' 

21. // et on lui assigne la valeur 'SingleGen( 1 a 1 )' . 

22 . // Le type requis du paramètre passé pour cette instance de 'SingleGen' 

23 . // est spécifié, mais il peut être omis, exemple - 

24. let _char: SingleGen<char> = SingleGen(' a '); 

25. 

26. 

27. let _t 

28. 

29. let _i32 

30. let _char 

31. } 


= SingleGen (A) ; / On passe une instance 

// du type 'A' définit en haut. 

= SingleGen (6); // On passe un entier de type 'i32'. 
= SingleGen (’ a ’); '/ On passe un 'char'. 


Voir aussi 
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Les structures 


12-1 - Les fonctions 


Les règles précédemment présentées s'appliquent également aux fonctions : un type T est générique lorsqu'il est 
précédé par la déclaration <T> (La lettre varie bien entendu selon le nom du type générique que vous donnez). 

Lorsque vous utilisez des fonctions génériques il peut, parfois, être nécessaire d'expliciter le type des paramètres 
dans le cas où, par exemple, la fonction appelée possède un type de renvoi générique, ou encore si le compilateur 
ne dispose pas d'assez d'informations pour inférer le type des paramètres. 

Une fonction dont le type des paramètres est explicité devrait ressembler à ceci : fn::<A, B, ...>(). 


1. struct A; //Le type "A' est concret. 

2. struct S(A); // Le type 'S' est concret. 

3. struct SGen<T>(T); // Le type 'SGen' est générique. 

4 . 

5. // Toutes les fonctions qui suivront possèdent les paramètres 

6. // qui leur sont passés et libèrent la mémoire aussitôt. 

7 . 

8. // On définit une fonction nommée 'reg_fn' qui prend un argument 's' de type 

9. // 'S'. Ce dernier n'est pas précédé d'un '<T>' (ou, en l'occurrence un '<S>') 

10. // donc le type n'est pas générique. 

11. fn reg_fn(_s: S) {} 

12 . 

13. // On définit une fonction nommée 'gen_spec_t' qui prend un argument '_s' de type 

14. // 'SGen<T>' . 

15. // Le type d'argument imposé à la structure SGen<T> est précisé, mais puisque 

16. // 'A' n'est pas précédé par le type générique '<A>', le type n'est pas générique. 

17. fn gen_spec_t(_s: SGen<A>) {} 

18. // A il aurait fallu déclarer 'A' comme générique: '<A>'. 

19. 

20. // On définit une fonction nommée 'gen_spec_i32 ' qui prend un argument 's' de 

21. // type 'SGen<i32>'. 

22. // Le type de paramètre supporté par la structure SGen a été spécifié, 'i32'. 

23. // Puisque 'i32' n’est pas un type générique, cette fonction n’est pas générique non plus. 

24. fn gen_spec_i32(_s: SGen<i32>) {} 

25. 

26. // On définit une fonction nommée 'generic' qui prend un paramètre 's' de type 

27. // 'SGen<T>' . 

28. // Puisque 'SGen<T>' est précédé par le type générique '<T>', 

29. // cette fonction est donc générique. 

30. fn generic<T>(_s: SGen<T>) {} 

31. 

32. fn main() { 

33. // Appel des fonctions 

34 . reg_fn (S (A) ) ; 

35. gen_spec_t(SGen (A) ); 

36. 

37. gen_spec_i32(SGen(6)); 

38. 


39. 




40. 

// 

Type du paramètre explicitement 

spécifié pour 

41. 

// 

la fonction 'generic()'. 


42 . 

// 

Le type peut être omis car le compilateur peut inférer 

43. 

// 

le type à partir du littéral. 


44 . 

generic: :<char> (SGen( ' a ' )); 


45. 




46. 

// 

Type du paramètre implicitement 

spécifié pour la fonction 

47 . 

// 

'generic()' car le compilateur i 

est capable d'inférer le type 

48. 

// 

à partir du littéral. 


49. 

generic(SGen( ' c ' )); 


50. } 





qui ne sont pas génériques. 

// On passe en paramètre un type concret. 

// Type 'A' implicitement spécifié car la fonction 
// n'accepte que la signature 'SGen<A>'. 

// Type 'i32' implicitement spécifié car la fonction 
// n'accepte que la signature 'SGen<i32>'. 


Voir aussi 
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Les fonctions, les structures. 


12-2 - Implémentation générique 


Tout comme les fonctions, les implémentations nécessitent quelques précisions pour être génériques. 


1. struct S; // On déclare le type concret 'S'. 

2. struct GenericVal<T>(T); // On déclare le type générique 'GenericVal' . 

3. 

4. // Implémentation de GenericVal où nous précisons que cette méthode doit être 

5. // implémentée uniquement pour le type 'f32'. 

6. impi GenericValtf32> { 

7. fn say_hello_f32 (Sself) -> (){ 

8. println! ("I' m a float! :D"); 

9. } 

10. } // On spécifie 'f32' 

11. impi GenericVal<S> { 

12. fn say_hello_s (Sself ) -> (){ 

13. println !( "I 1 m a S object! :D"); 

14. } 

15. } // On spécifie le type 'S' pour les mêmes raisons qu 1 au-dessus. 

16. // '<T>' doit précéder le type pour le rendre générique. 

17. impi <T> GenericVal<T> { 

18. fn say_hello (Sself ) -> (){ 

19. println! ("I’m a generic object! :D"); 

20. } 

21. } 

22 . 

23. struct Val { 

24. val: f64 

25. } 

26. 

27. struct GenVal<T>{ 

28. gen_val: T 

29. } 

30. 

31. // Implémentation de Val. 

32. impi Val { 

33. fn value (Sself) -> &f64 { Sself.val } 

34. } 

35. 

36. j Implémentation de GenVal pour le type générique 'T'. 

37. impi <T> GenVal<T> { 

38. fn value (Sself) -> &T { &self .gen_val } 

39. } 

40. 

41. fn main() { 

42. let x = Val { val: 3.0 }; 

43. let y = GenVal { gen_val: 3i32 }; 

44 . 

45. println !("{}, {}", x.value!) , y. value!) ); 

46. GenericVal(1.0).say_hello_f32(); 

47. GenericVal(S).say_hello_s(); 

48. GenericVal( "prout" ).say_hello(); 

49. } 


Voir aussi 

Renvoi de références, impi, les structures. 


12-3 - Les traits 


Bien entendu, les traits peuvent également être génériques. Dans cette section, nous allons en créer un qui ré¬ 
implémente le trait Drop qui proposera une méthode générique qui aura pour fonction de libérer l'instance qui l'appelle 
ainsi qu'un paramètre passé. 
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1. // Types non-copiables. 

2. struct Empty; 

3. struct Null; 

4 . 

5. // Un trait générique qui reçoit un type générique 'T'. 

6. trait DoubleDrop<T> { 

7. //On déclare une méthode qui sera implémentée par la structure 

8 . 

// appelante (caller) et prendra un paramètre 'T' en entrée mais n'en fera rien (juste le libérer). 

9. fn double_drop (self , T); 

10 . } 

11. 

12. // On implémente 'DoubleDrop<T>' pour n'importe quel paramètre 'T' et 

13. // n’importe quelle structure appelante ('U'). 

14. impl<T, U> DoubleDrop<T> for U { 

15. // Cette méthode prend "possession" des deux paramètres ('U' et 'T'), 

16. //et sont donc tous deux libérés. 

17. fn double_drop (self , T) {} 

18. } 

19. 

20. fn main() { 

21. let empty = Empty; 

22. let null = Null; 

23. 

24. // 'empty' et 'null' sont désalloués. 

25. empty.double_drop(null); 

26. 

27. // empty; 

28. // null; 

29. // A TODO: Essayez de décommenter ces lignes. 

30. } 


Voir aussi 

La documentation du trait Drop, le chapitre sur les structures et les traits. 


12-4 - Les restrictions 


Lorsque nous travaillons avec la généricité, il est courant d'assigner une « restriction » à un type générique pour 
spécifier quel trait il doit implémenter. Dans l'exemple suivant, nous utilisons le trait Display pour afficher quelque 
chose en console, il est alors assigné au type T. Autrement dit, T doit implémenter Display. 


1. 

// 

On déclare 

une fonction nommée 'printer' qui 

prend, 

en entrée, 

2 . 

// 

un type générique 'T' qui doit implémenter le 

trait 

'Display'. 

3. 

fn 

printerCT: 

Display>(t: T) { 



4 . 

5. 

} 

println! ( ' 

t); 




Les ressources passées en paramètre sont toutes soumises à ces restrictions et doivent forcément remplir les 
conditions : 

1. struct S<T: Display>(T); 

2 . 

3. // Erreur! 'Vec<T>' n'implémente pas le trait 'Display'. 

4. let s = S(vec![l]); 

Les instances des types génériques peuvent également accéder aux méthodes appartenant au(x) trait(s) présent(s) 
dans les restrictions du type. Par exemple : 

1. //Un trait qui implémente le marqueur v {:?}'. 

2. use std::fmt: :Debug; 

3. 

4. trait HasArea { 

5. fn area(&self) -> f64; 

6 . } 
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7. 

8. impi HasArea for Rectangle { 

9. fn area(&self) -> f64 { self.length * self.height } 

10 . } 

11. 

12. #[dérivé(Debug)] 

13. struct Rectangle { length: f64, height: f64 } 

14. #[allow(dead_code)] 

15. struct Triangle { length: f64, height: f64 } 

16. 

17. // Le type générique 'T' doit implémenter le trait 'Debug'. 

18. // Qu'importe le type de 'T', cela fonctionnera. 

19. fn print_debug<T: Debug>(t: ST) { 

20. println !("{:?}" , t); 

21 . } 

22 . 

23. // 'T' doit implémenter le trait 'HasArea'. N'importe quelle 

24. // structure remplissant les conditions d'entrée peut accéder 

25. // à la méthode 'area' du trait 'HasArea'. 

26. fn area<T: HasArea>(t: ST) -> f64 { t.areaO } 

27 . 

28. fn main() { 

29. let rectangle = Rectangle { length: 3.0, height: 4.0 }; 

30. let _triangle = Triangle { length: 3.0, height: 4.0 }; 

31. 

32. print_debug(Srectangle); 

33. println !( "Area : {}", area (Srectangle)); 

34. 

35. // print_debug(S_triangle); 

36. // println!("Area: {}", area(S_triangle)); 

37. // A T0D0: Essayez de décommenter ces lignes. 

38. // | Erreur: N'implémente pas l'un de ces traits: 'Debug' ou 'HasArea'. 

39. } 


Les conditions d'entrée pour les paramètres génériques peuvent également être spécifiées en utilisant le mot-clé 
where, les rendant plus explicites, plus lisibles. 

Voir aussi 

Les traits dédiés à l'affichage et le formatage std::fmt, les structures et les traits. 


12-4-1 - Exemple d'utilisation : Traits sans services 


Puisqu'il est possible d'imposer des conditions aux types génériques grâce aux traits, même si ces derniers ne 
possèdent aucune fonctionnalité (i.e. aucun service, aucune méthode), il est toujours possible de vous en servir 
comme simple « filtre ». Eq et Ord font partie de ces traits « vides » fournis par la bibliothèque standard. 


1. struct Cardinal; 

2. struct BlueJay; 

3. struct Turkey; 

4 . 

5. trait Red {} 

6. trait Blue {} 

7 . 

8. impi Red for Cardinal {} 

9. impi Blue for BlueJay {} 

10. 

11. // Ces fonctions ne prendront en entrée que des ressources 

12. // ayant implémenté les traits "Red" ou 'Blue'. 

13. // Le fait que ces derniers soient vides n’a que peu d’importance. 

14. fn red<T: Red>(_: ST) -> S'static str { "red" } 

15. fn blue<T: Blue>(_: ST) -> s'static str { "blue" } 

16. 

17. fn main ( ) { 

18. let cardinal = Cardinal; 

19. let blue_jay = BlueJay; 

20. let _turkey = Turkey; 
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21 . 

22. // La fonction 'red()' ne fonctionnera pas sur une instance 

23. // de la structure 'BlueJay', et vice versa, à cause des 

24. // restrictions imposées par les fonctions (i.e. ’red() ' et 'blueO'). 

25. println! ("A cardinal is {}", red(Scardinal)); 

26. println! ("A blue jay is {}", blue(&blue_jay)); 

27. //println!( "A turkey is {}", red(&_turkey)); 

28. // TODO: Essayez de décommenter cette ligne. 

29. } 


Voir aussi 

La documentation du trait Eq, la documentation du trait Ord et les traits. 


12-5 - Restrictions multiples 


Il est possible d'additionner les conditions grâce à l'opérateur +. Tout comme les types concrets, les types génériques 
sont séparés par une virgule ,. 


1. use 

2 . 

3. f n 

std::fmt::{Debug, Display} 



compare prints<T: Debug + Display>(t: &T) 

{ 

4 . 

println!("Debug: '{:?}", 

t) ; 


5. 

println! ("Display: 

t) ; 


6. } 

7 . 

8 . fn 

compare types<T: Debug, U: 

Debug>(t: &T, 

u: &D) { 

9. 

println! ("t: t) ; 



10. 

11. } 
12 . 

println! ("u: '{:?}", u) ; 



13. fn 

main() { 



14 . 

let string = "words"; 



15. 

let array = [1, 2, 3] ; 



16. 

let vec = vec! [1, 2, 3] ; 



17 . 




18. 

compare prints(Sstring); 



19. 

// compare prints(&array) 

; 


20. 

// TODO A Essayez de décommenter cette 

ligne. 

21. 




22 . 

compare types(Sarray, Svec); 


23. } 





Voir aussi 

std::fmt, les traits. 


12-6 - La clause where 


Une restriction peut également être explicitée par la clause where. Cette dernière se trouvera alors avant l'accolade 
ouvrante ({) plutôt qu'à la déclaration du type(e.g. <A: Display, B: Debug, ...>). Avec where, vous pouvez également 
ajouter arbitrairement d'autres types en plus de spécifier les traits à implémenter pour les types génériques. 

where peut être utile dans plusieurs cas : 

• Lorsque vous ajoutez des restrictions aux types génériques, facilitant la lecture : 


1. impi <A: TraitB + Traite, D: TraitE + TraitF> MyTraitkA, D> for YourType {} 

2 . 

3. // Les restrictions sont explicitées 

4. // par la condition 'where'. 

5. impi <A, D> MyTraitkA, D> for YourType where 
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6. A: TraitB + Traite, 

7. D: TraitE + TraitF {} 

Lorsque d'autres types sont ajoutés aux restrictions : 


1. use std: : fmt : : {Debug, Formatter, Resuit}; 

2 . 

3. trait PrintlnOption { 

4. fn print_in_option (self ); 

5. } 

6 . 

7. // Parce que nous pourrions modifier la restriction sans spécifier le 

8. // conteneur 'T: Debug' ou adopter une autre approche, 

9. // il est nécessaire d'utiliser la condition 'where': 

10. impl<T> PrintlnOption for T where 

11. Option<T>: Debug{ 

12. // Nous spécifions la restriction de type 'Option<T>: Debug' parce que 

13. // c'est ce que nous souhaitons afficher. Faire autrement pourrait nous 

14. // induire en erreur quant au type de restriction à spécifier. 

15. fn print_in_option (self ) { 

16. println !("{:?}" , Some(self)); 

17. } 

18. } 

19. 

20. fn main() { 

21. let vec = vec![1 , 2 , 3] ; 

22. vec.print_in_option(); 

23. } 


Voir aussi 

RFC pour la condition/clause where, les structures, les traits. 


12-7 - Les éléments associés 


Le concept « d'éléments associés » est un ensemble de règles appliquées sur différents types d'éléments. C'est une 
extension des traits génériques, leur permettant de définir de nouveaux « éléments » en leur sein ; En l'occurrence, 
ces derniers sont nommés « types associés » et proposent une approche moins fastidieuse pour l'utilisation des 
patterns (e.g. déclaration des types) lorsqu'un trait reçoit des paramètres génériques en entrée. 

Voir aussi 

La RFC des éléments associés. 


12-7-1 - Le problème 


Un trait qui possède des types génériques en entrée doit respecter certaines règles : Les utilisateurs du trait doivent 
spécifier tous les types de données génériques supportés par le conteneur. 

Dans l'exemple ci-dessous, le trait Contains permet l'utilisation des types génériques A et B. Le trait est alors 
implémenté pour le type Container en spécifiant le type i32 pour les deux types génériques (i.e. A et B). Ils peuvent 
donc être soumis à la fonction fn difference(). 

Puisque le type Contains est générique, nous sommes obligés de déclarer tous les types génériques supportés par 
Contains pour la fonction difference(). En pratique, nous opterions pour une approche nous permettant d'inférer les 
types génériques supportés par Contains à partir de l'entrée C. C'est ce que nous verrons dans la section suivante, 
car les types associés autorisent cette approche. 


1. struct Container(132, i32); 

2 . 
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3. 

4 . 

5. 

6 . 

7 . 

8 . 

9. 

10 . 
11. 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21. 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 


// Nous déclarons un trait qui vérifie si deux items 
// par le conteneur. 

// Le conteneur pourra également fournir la première 
// valeur. 

trait Contains<A, B> { 

fn contains(Sself, &A, &B) -> bool; 
fn first (Sself) -> i32; 
fn last(Sself) -> i32; 


sont contenus 
ou dernière 


impi Contains<i32, i32> for Container { 

// Renvoie 'true' si les nombres stockés sont égaux, 
fn contains(Sself, number_l: &i32, number_2: &i32) -> bool { 
(Sself.O == number_l) && (Sself.l == number_2) 

} 

//On récupère la première valeur, 
fn first (Sself) -> i32 { self.O } 

//On récupère la dernière valeur, 
fn last(Sself) -> i32 { self.l } 


// 'C' contient 'A' et 'B'. Les déclarer une nouvelle fois dans les paramètres 
// génériques de la fonction est fastidieux, 
fn difference<A, B, C> (container : &C) -> i32 where 
C: Contains<A, B> { 

container.last ( ) - container.first() 


fn main() { 

let number_l = 3; 
let number_2 = 10; 

let container = Container(number_l, number_2); 

println! ( "Does container contain {} and {} : {}", 

&number_l, &number_2, 

container.contains(&number_l, &number_2)); 
println! ("First number: {}", container.first ()); 
println! ("Last number: {}", container.last()); 

println! ("The différence is: {}", différence(Scontainer)); 


Voir aussi 

Les structures. 


12-7-2 - Les types associés 


L'utilisation des « types associés » améliore la lisibilité du code en assignant les types génériques, au sein du trait, 
comme « types de sortie ». La syntaxe pour les déclarer est la suivante : 


1. // 'A' et 'B' sont déclarés au sein du trait par le biais du mot-clé 'type'. 

2. // Notez toutefois que 'type', dans ce contexte, n’a pas la même fonction 

3. // que le 'type' utilisé pour créer des alias. 

4. trait Contains { 

5. type A; 

6. type B; 

7 . 

8. //La syntaxe a été modifiée pour faire référence aux types génériques. 

9. fn contains (Sself, &Self::A, &Self::B) -> bool; 

10 . } 


Notez que les fonctions qui utilisent le trait Contains n’ont plus du tout besoin de déclarer les types génériques A et B : 
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1. // Sans les types associés. 

2. fn difference<A, B, C> (container: &C) -> i32 where 

3. C: Contains<A, B> { ... } 

4. 

5. // Avec les types associés. 

6. fn difference<C: Contains>(container: &C) -> i32 { ... } 

Éditons l'exemple de la section précédente en utilisant les types associés : 


1. struct Container(132, i32); 

2 . 

3. // Nous déclarons un trait qui vérifie si deux items sont stockés 

4. // dans le conteneur. 

5. // Le conteneur pourra également fournir la première ou dernière valeur. 

6. trait Contains { 

7. // Nous définissons une bonne fois pour tous les types génériques 

8. // que les méthodes/fonctions pourront utiliser. 


9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 


type A; 
type B; 

fn contains(&self, &Self::A, &Self::B) -> bool; 
fn first (&self) -> i32; 
fn last(Sself) -> i32; 


impi Contains for Container { 

// On précise le type de 'A' et 'B'. Si le type d'entrée est 
// 'Container (i32, i32)', les types de sorties seront alors 
// typés tous les deux 'i32'. 
type A = i32; // typé i32 
type B = i32; // typé i32 

// '&Self::A' et '&Self::B' sont également valides ici. 

// Essayez de remplacer la référence number_l('&i32') par '&Self::A', 
// et la référence number_2('&i32) par '&Self::B'! 
fn contains (Sself, number_l: &i32, number_2: &i32) -> bool { 

(Sself.O == number_l) && (Sself.l == number_2) 

} 

// Récupère la première valeur, 
fn first (Sself) -> i32 { self.O } 

// Récupère la dernière valeur, 
fn last(Sself) -> i32 { self.l } 

} 

fn difference<C: Contains>(container: &C) -> i32 { 
container.last ( ) - container.first() 

} 

fn main() { 

let number_l = 3; 
let number_2 = 10; 

let container = Container(number_l, number_2); 

println! ( "Does container contain {} and {}; {}", 

&number_l, &number_2, 

container.contains(&number_l, &number_2)); 
println! ("First number: {}", container.first()); 
println! ("Last number: {}", container.last()); 

println! ("The différence is: {}", différence(Scontainer)); 

} 


12-8 - Les paramètres fantômes 


Un type de paramètre fantôme n'est pas utilisé à l'exécution, mais est vérifié statiquement (et seulement) au moment 
de la compilation. 
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Les types de données peuvent utiliser des types de paramètres génériques supplémentaires pour agir en tant que 
« marqueurs » ou pour effectuer une vérification du/des type(s) au moment de la compilation. Ces paramètres 
« supplémentaires » ne stockent aucune ressource et sont inactifs à l'exécution. 

Dans l'exemple ci-dessous, nous présentons la structure std::marker::PhantomData avec le concept de « type de 
paramètre fantôme » pour créer des tuples contenant différents types de données. 


1. use std::marker::PhantomData; 

2 . 

3. // Un tuple qui prend un type générique 'A' et un paramètre fantôme 'B'. 

4. #[dérivé(PartialEq)] // Permet de tester l'égalité entre les instances du type. 

5. struct PhantomTuple<A, B>(A,PhantomData<B>); 

6 . 

7. // Un tuple qui prend un type générique 'A' et un paramètre fantôme 'B'. 

8. #[dérivé(PartialEq)] // Permet de tester l'égalité entre les instances du type. 

9. struct PhantomStruct<A, B> { first: A, phantom: PhantomData<B> } 

10. 

11. // Note: De la mémoire sera allouée pour le type générique 'A', mais pas pour 'B'. 

12. // En revanche, 'B' ne pourra pas être utilisé à l'exécution. 

13. 

14. fn main() { 

15. // Ici, les types 'f32' et 'f64' sont des paramètres fantômes. 

16. // Types spécifiés pour PhantomTuple: 'Cchar, f32>'. 

17. let _tuplel: PhantomTupleCchar, f32> = PhantomTuple(' Q' , PhantomData); 

18. // Types spécifiés pour PhantomTuple: 'Cchar, f64>'. 

19. let _tuple2: PhantomTupleCchar, f64> = PhantomTuple(' Q' , PhantomData); 

20 . 

21. // Types spécifiés pour PhantomStruct: 'Cchar, f32>'. 

22. let _structl: PhantomStructCchar, f32> = PhantomStruct { 

23. first: 'Q' , 

24. phantom: PhantomData, 

25. } ; 

26. // Types spécifiés pour PhantomStruct: 'Cchar, f64>'. 


27 . 

let struct2: PhantomStructCchar, f64> = PhantomStruct { 

28. 


first: 'Q', 




29. 


phantom: PhantomData, 




30. 

} ; 





31. 






32. 

// 

Erreur! Les deux ressources ne peuvent 

pas 

être 

comparées 

33. 

// 

println!(" tuplel == tuple2 yields: {} 

r 



34. 

// 

tuplel == tuple2); 




35. 






36. 

// 

Erreur! Les deux ressources ne peuvent 

pas 

être 

comparées 

37. 

// 

println!(" structl == struct2 yields: 




38. 

// 

structl == struct2); 





39. } 


Voir aussi 

L'attribut Dérivé, les structures et les tuples. 


12-8-1 - Exemple d'utilisation Petite précision 


Nous allons créer une méthode chargée de calculer dans deux unités de mesure différentes (le pied et le millimètre) 
et nous implémenterons le trait Add avec un type générique fantôme. Voici l'implémentation du trait Add : 


1. // Cette implémentation devrait imposer: 'Self + RHS = Output' 

2. // où 'Self' est la valeur par défaut de 'RHS' si elle n'est pas spécifiée 

3. // dans l'implémentation. 

4. 

5. pub trait AddCRHS = Self> { 

6. type Output; 

7. 

8. fn add(self, rhs: RHS) -> Self ::Output; 

9. } 

10 . 
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11. // 'Output' doit être de type 'T<U>' pour que 'T<U> + T<U> = T<U>'. 

12. impl<U> Add for T<0> { 

13. type Output = T<U>; 

14 . 

15. } 


Voici l'implémentation complète : 

1. use 

std::ops: :Add; 



2. use 

O 

std::marker:;PhantomData; 



■D • 

4. III 

On créé des énumérations vides pour déclarer le type des 



5. Il unités de mesures. 

6. #[dérivé(Debug, Clone, Copy)] 



7 . enum 

Inch {} 



8. #[dérivé(Debug, Clone, Copy)] 



9. enum 

10. 

Mm { } 



11. III 

'Length' est une structure prenant un type générique fantôme 'Unit 

', 

12. III 

'f64' implémente déjà les traits 'Clone' et 'Copy'. 



13. #[dérivé(Debug, Clone, Copy)] 

14. struct Length<Unit>(f64, PhantomData<Unit>); 



15. 

16. III 

Le trait 'Add' définit le comportement de l'opérateur '+' 



17. impl<Unit> Add for Length<Unit> { 



18. 

19. 

20. 

type Output = Length<Unit>; 



// La méthode add() renvoie une nouvelle instance de la 



21. 

// structure 'Length' contenant la somme. 



22 . 

fn add(self, rhs: Length<Unit>) -> Length<Unit> { 



23. 

// L'opérateur '+' appelle l'implémentation 



24 . 

// du trait 'Add' pour le type 'f64'. 



25. 

26. 

27. } 

28. 

Length (self . 0 + rhs.O, PhantomData) 

} 



29. fn 

main() { 



30. 

// On initialise 'one foot' pour avoir un type générique 

fantôme 

Inch'. 

31. 

// Ce "fantôme" sert de marqueur et classe cette instance 

dans 


32. 

// l'unité de mesure "Pied". 



33. 

let one foot: Length<Inch> = Length(12.0, PhantomData); 



34. 

// On initialise 'one meter' pour avoir un type générique 

fantôme 

'Mm' . 

35. 

// Ce "fantôme" sert de marqueur et classe cette instance 

dans 


36. 

// l'unité de mesure "Millimètre". 



37. 

let one meter: Length<Mm> = Length (1000 .0, PhantomData) 

; 


38. 




39. 

// L'opérateur '+' appelle la méthode 'add()' que nous avons 


40. 

// précédemment implémentée pour 'Length<Unit>'. 



41. 

// Maintenant que 'Length' implémente le trait 'Copy', 'add()' ne 


42 . 

// prend pas possession (ne consomme pas) 'one foot' et 

one meter 

mais 

43. 

// les copie dans 'self' et 'rhs'. 



44 . 

let two feet = one foot + one foot; 



45. 

let two meters = one meter + one meter; 



46. 




47 . 

/ / L'addition fonctionne. 



48. 

println! ("one foot + one foot = {:?} in", two feet.O); 



49. 

println! ("one meter + one meter = {:?} mm", two meters.0) 

; 


50. 




51. 

// Les opérations illogiques échouent comme prévu: 



52. 

// Erreur à la compilation: mismatched type. 



53. 

// let one feter = one foot + one meter; 



54. } 





Voir aussi 

Le système d'emprunts, les restrictions, les énumérations, impi et self, la surcharge des opérateurs, le pattern 
ref, les traits et les tuples. 
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13 - Les contextes 


Les contextes jouent un rôle important dans le fonctionnement du systèmes de propriété (ownership), d'emprunts 
(borrowing) et de durées de vie (lifetime). Ils témoignent de la validité (ou non) d'un emprunt, indiquent au compilateur 
lorsqu'une ressource peut être libérée et lorsqu'une variable est créée ou détruite. 


13-1 - Le RAII 


En Rust, les variables ne stockent pas seulement leurs données dans la pile : Elles sont responsables de leurs 
ressources (e.g. le conteneur Box<T> possède, alloue de la mémoire dans le tas). Rust imposant l'approche du RAII, 
lorsqu'un objet sort du contexte, son destructeur est appelé et les ressources, possédées par l'objet, sont libérées. 

Ce fonctionnement prévient les problèmes de fuites mémoire et nous dispense donc de gérer manuellement la 
mémoire. Voici un exemple : 


1. // 

Dans 

le fichier raii.rs 


2. fn 

create box() { 


3. 

// Allocation d'un entier dans le tas. 


4 . 

let 

boxl = Box : :new(3i32); 


5. 




6. 

7. } 

// ' 

boxl' est détruit ici, et la mémoire est 

libérée. 

8. 

9. fn 

main() { 


10. 

// 

Allocation d'un entier dans le tas. 


11. 

let 

box2 = Box : :new(5i32); 


12 . 




13. 

// 

Contexte imbriqué: 


14 . 

{ 



15. 


// Allocation d'un entier dans le tas. 


16. 


let box3 = Box : :new(4i32); 


17 . 




18. 


// v box3' est détruit ici, et la mémoire 

est libérée. 

19. 

} 



20. 




21. 

// 

On créé ici un grand nombre de "box" juste 

pour l'exemple. 

22 . 

// 

Il n'y a pas besoin de libérer manuellement la mémoire ! 

23. 

for 

- _ in 0u32..1^000 { 


24 . 


create box(); 


25. 

} 



26. 




27 . 

// 

'_box2' est détruit ici, et la mémoire est 

libérée. 

28. } 





Bien entendu, vous pouvez vérifier par vous-même si des fuites sont présentes en utilisant valgrind : 

1. $ rustc raii.rs && valgrind ./raii 

2. ==26873== Memcheck, a memory error detector 

3. ==26873== Copyright (C) 2002-2013, and GNU GPL'd, by Julian Seward et al. 

4. ==26873== Using Valgrind-3. 9 . 0 and LibVEX; rerun with -h for copyright info 

5. ==26873== Command: ./raii 

6. ==26873== 

7. ==26873== 

8. ==26873== HEAP SUMMARY: 

9. ==26873== in use at exit: 0 bytes in 0 blocks 

10. ==26873== total heap usage: 1,013 allocs, 1,013 frees, 8,696 bytes allocated 

11. ==26873== 

12. ==26873== Ail heap blocks were freed -- no leaks are possible 

13. ==26873== 

14. ==26873== For counts of detected and suppressed errors, rerun with: -v 

15. ==26873== ERROR SUMMARY: 0 errors from 0 contexts (suppressed: 2 from 2) 


Voir aussi 
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13-2 - Ownership et transferts 


Parce que les variables sont responsables de la libération de leurs ressources, les ressources ne peuvent avoir 
qu'un seul propriétaire/responsable. 

Cette règle évite également au développeur de libérer plus d'une fois une ressource. Notez toutefois que toutes les 
variables ne possèdent pas leurs propres ressources (e.g. les références). 

Lorsque nous assignons quelque chose à une variable (let x = y) ou passons un (ou des) argument à une fonction par 
valeur (foo(x)), l'ownership des ressources est transféré. Dans le jargon, cette action est nommée « move » (transfert). 

Après avoir transféré une ressource, l'ancien propriétaire ne peut plus être utilisé. Cela prévient la création de 
« dangling pointers » (i.e. des pointeurs sur une ressource qui n'est plus valide). 


— Il 

Cette fonction prend possession d'un entier alloué dans le tas. 


2 . fn 

destroy box(c: Box<i32>) { 


3. 

4 _ 

println! ("Destroying a box that contains {}", c) ; 


5. 

6 . } 

// 'c' est détruit et la mémoire va être libérée. 


7 . 

8 . fn 

main() { 


9. 

// Entier alloué dans la pile. 


10 . 

let x = 5u32; 


11 . 



12 . 

// On copie 'x' dans 'y' - aucune ressource n'a été transféré 


13. 

// (l'ownership n'a pas été transféré). 


14 . 

let y = x; 


15. 



16. 

// Les deux valeurs peuvent être utilisées indépendamment. 


17 . 

println! ("x is {}, and y is {}", x, y); 


18. 



19. 

// 'a' est un pointeur sur un entier alloué dans le tas. 


20 . 

let a = Box : :new(5i32); 


21 . 



22 . 

println! ("a contains: {}", a); 


23. 



24 . 

// On transfert 'a' dans 'b'. 


25. 

let b = a; 


26. 

// L'adresse du pointeur 'a' est copié (et non la donnée) dans 'b 


27 . 

// 'a' et 'b' sont désormais des pointeurs sur la même donnée allouée dans le 

28. 

// tas, mais 'b' la possède, désormais. 


29. 



30. 

// Erreur! 'a' ne peut plus accéder à la donnée car il ne possède 

plus 

31. 

// le bloc mémoire. 


32. 

// println!("a contains: {}", a); 


33. 

// TODO A Essayez de décommenter cette ligne. 


34. 



35. 

// Cette fonction prend possession de la mémoire allouée dans le tas 

36. 

// à partir de 'b'. 


37. 

destroy box(b); 


38. 



39. 

// Puisque la mémoire allouée a été libérée à partir d'ici. 


40. 

// cette action consisterait à déréférencer de la mémoire libérée 


41. 

// mais cela est interdit par le compilateur. 


42 . 

// Erreur! 'b' ne peut plus accéder à la donnée car il ne possède 

plus 

43. 

// le bloc mémoire. 


44 . 

// println!("b contains: {}", b); 


45. 

// TODO A Essayez de décommenter cette ligne. 


46. } 
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13-2-1 - Mutabilité 


La mutabilité d'une donnée peut être altérée lorsque l'ownership est transféré. 


1 . 

fn main() { 


2 . 

O 

let immutable box = Box 

: :new (5u32); 

■J . 

4 . 

C 

println! ("immutable box 

contains {}", immutable box); 

D . 

6 . 

// Erreur: 'immutable box' ne peut pas être déréférencé. 

7 . 

O 

// *immutable box = 4; 


O . 

9. 

// On créé une copie mutable de 'immutable box'. 

10 . 

let mut mutable box = 

immutable box; 

11 . 



12 . 

println! ("mutable box 

contains {} " , mutable box); 

13. 



14 . 

// On modifie le contenu de la box. 

15. 

^mutable box = 4; 


16. 



17 . 

println! ("mutable box 

now contains {}", mutable box); 

18. 

. } 



13-3 - Système d'emprunts 


Très souvent, nous souhaiterions accéder à une ressource sans en prendre possession. Pour ce faire, Rust utilise 
un système d'emprunts. Plutôt que de passer un objet par valeur (T), il peut être passé par référence (&T). 

Le compilateur garantit (grâce au vérificateur d'emprunts) que les références sont toujours valides. Tant qu'une 
référence de l'objet existe, il ne sera pas détruit. 


1. // Cette fonction prend possession d'une box et la détruit. 

2. fn eat_box_i32(boxed_i32: Box<i32>) { 

3. println! ("Destroying box that contains {}", boxed_i32); 

4 . } 

5. 

6 . // Cette fonction emprunte un entier signé 

7. // codé sur 32 bits. 


9. 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 


fn borrow_i32(borrowed_i32: &i32) { 

println! ("This int is: {}", borrowed_i32); 


fn main() { 

// On créé entier alloué dans le tas 
// et un autre alloué dans la pile, 
let boxed_i32 = Box::new(5_i32); 
let stacked_i32 = 6_i32; 

// 'borrow_i32()' emprunte le contenu de la box. 

// La fonction ne prend pas possession des ressources, 
// donc le contenu peut être de nouveau emprunté. 
borrow_i32(&boxed_i32); 
borrow i32 (Sstacked i32); 


{ 


// Récupère une référence de l'entier contenu dans la box. 
let _ref_to_i32: &i32 = &boxed_i32; 

// Erreur! 

// Vous ne pouvez pas détruire 'boxed_i32' tant que la valeur 
// qu'il contient est empruntée. 

// eat_box_i32(boxed_i32); 

// FIXME A Essayez de décommenter cette ligne. 

// La durée de vie de "_ref_to_i32' prend fin ici, 

// l'entier n'est donc plus emprunté. 
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36. } 

37. 

38. // 'boxed_i32' peut désormais être possédé par 'eat_box()' et peut donc 

39. // être détruit. 

40. eat_box_i32(boxed_i32); 

41. } 


13-3-1 - Mutabilité 


Une ressource mutable peut être modifiée, tout en étant empruntée, en utilisant &mut T. Nous passons alors une 
référence mutable de la ressource, donnant un accès en lecture et en écriture à l'emprunteur. En revanche, une 
référence dont la mutabilité n'est pas précisée (i.e. que le mot-clé mut n'est pas présent) empêche l'emprunteur 
d'accéder en écriture à la ressource. 


1. # [allow(dead_code)] 

2. #[dérivé(Clone, Copy)] 

3. struct Book { 

4. // 'S'static str' est une référence d'une chaîne de caractères allouée 

5. // dans un bloc mémoire qui ne peut être accédé qu'en lecture. 

6. author: S'static str, 

7. title: S'static str, 

8. year: u32, 

9. } 

10. 

11. // Cette fonction prend une référence d'une instance 

12. // de la structure 'Book' en paramètre. 

13. fn borrow_book(book: SBook) { 

14. println! ("I immutably borrowed {} - {} édition", book.title, book.year); 

15. } 

16. 

17. // Cette fonction prend une référence mutable d'une instance de la 

18. // structure 'Book' en paramètre, et initialise sa date de publication 

19. // à 2014. 

20. fn new_edition(book: Smut Book) { 

21. book.year = 2014; 

22. println! ("I mutably borrowed {} - {} édition", book.title, book.year); 

23. } 

24 . 

25. fn main() { 

26. //On créé une instance immuable de la 

27. // structure 'Book' nommée 'immutabook'. 

28. let immutabook = Book { 

29. // Les chaînes littérales sont typées 'S'static str'. 

30. author: "Douglas Hofstadter", 

31. title: "Gôdel, Escher, Bach", 

32. year: 1979, 

33. } ; 

34. 

35. //On créé une copie mutable de 'immutabook' nommée 

36. // 'mutabook'. 

37. let mut mutabook = immutabook; 

38. 

39. // Emprunte un objet en lecture seule. 

40. borrow_book(Simmutabook); 

41. 

42. // Emprunte un objet en lecture seule. 

43. borrow_book(Smutabook); 

44 . 

45. // Récupère une référence mutable d'un objet mutable. 

46. new_edition( Smut mutabook); 

47 . 

48. // Erreur! Vous ne pouvez pas récupérer une référence 

49. // mutable d'un objet immuable. 

50. // new_edition(Smut immutabook); 

51. // FIXME A Décommentez cette ligne. 

52. } 


Voir aussi 


- 66 - 

Le contenu de cet article est rédigé par Rust Core Team et est mis à disposition selon les termes de la Licence Creative Commons Attribution 3.0 non transposé. Les logos Developpez.com, 
en-tête, pied de page, css, et look & feel de l'article sont Copyright ® 2013 Developpez.com. 

http://rust.developpez.com/tutoriels/rust-par-l-exemple/ 






Dcv&leppcK.com 

Club 4ti développeur/ 


Rust par l'exemple par Rust Core Team 


La lifetime 'static. 


13-3-2 - Verrouillage des ressources 


Lorsqu'une référence immuable d'une ressource est récupérée, cette dernière est également « gelée », « verrouillée ». 
Lorsqu'une ressource est gelée, l'objet initial (celui à partir duquel une référence a été récupérée) ne peut être modifié 
jusqu'à ce que toutes les références soient détruites(i.e. ne figurent plus dans le contexte). 

1 . fn main() { 

2. let mut _mutable_integer = 7i32; 

3. 

4. { 

5. // On emprunte '_mutable_integer'. 

6. // Accès en lecture uniquement. 

7. let _large_integer = &_mutable_integer; 

8 . 

9. // Erreur! '_mutable_integer' est gelé dans ce contexte 

10 . // (i.e. la ressource est empruntée). 

11. // _mutable_integer = 50; 

12. // FIXME A Décommentez/commentez cette ligne. 

13. 

14. // On sort du contexte de '_large_integer’. 

15. } 

16. 

17. // Aucun problème! '_mutable_integer' n’est plus gelé dans ce contexte. 

18. _mutable_integer = 3; 

19. } 


13-3-3 - Limitations des accès lecture/écriture 


Il est possible de faire autant « d'emprunts immuables » (i.e. récupérer une référence immuable) qu'on le souhaite. 
Toutefois, tant qu'il y a des accès en lecture par référence, l'objet original ne peut pas être modifié. Par contre, un 
seul accès en écriture, par ressource, est permis tant que le dernier emprunt par référence mutable n'est pas terminé 
(i.e. tant que la référence mutable est toujours dans le contexte). 


1. struct Point { x: i32, y: i32, z: i32 } 

2 . 

3. fn main ( ) { 

4. let mut point = Point { x: 0, y: 0, z: 0 }; 

5. 

6 . { 

7. let borrowed_point = &point; 

8 . let another_borrow = &point; 

9. 

10. // Vous pouvez accéder à la ressource par le biais des références 

11 . // créées et par l'objet original. 

12. println !( "Point has coordinates: ({}, {}, {})", 

13. borrowed_point.x, another_borrow.y, point.z); 

14. 

15. // Erreur! Vous ne pouvez pas avoir des accès en écriture à une ressource 

16. // qui est déjà empruntée par une référence immuable (i.e. accès en lecture). 

17. // let mutable_borrow = &mut point; 

18. // TODO A Essayez de décommenter cette ligne. 

19. 

20. // On sort du contexte des références 

21 . // immuables. 

22 . } 

23. 

24. { 

25. let mutable_borrow = &mut point; 

26. 

27. // On modifie la ressource par le biais d'une 

28. // référence mutable. 

29. mutable_borrow.x = 5; 

30. mutable_borrow.y = 2; 

31. mutable borrow.z = 1; 
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32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 


// Erreur! Vous ne pouvez pas accéder à 'point' en lecture 

// alors que la ressource est potentiellement en train d'être modifiée. 

// let y = Spoint.y; 

// TODO A Essayez de décommenter cette ligne. 

// Erreur! On ne peut pas afficher 'point.z' en utilisant 

// la macro 'println!' car elle prend en paramètre une référence 

// immuable. 

// println! ("Point Z coordinate is {}", point.z); 

// TODO A Essayez de décommenter cette ligne. 

// Ok! Les références mutables peuvent être passées comme 

// références immuables à 'println!'. 

println! ("Point has coordinates: ({}, {}, {})", 

mutable_borrow.x, mutable_borrow.y, mutable_borrow.z); 

// On sort du contexte des références 
// mutables. 

} 

// Les accès en lecture sur 'point' sont de nouveau 
// permis par le vérificateur d'emprunts, 
let borrowed_point = Spoint; 

println! ("Point now has coordinates: ({}, {}, {})", 

borrowed_point.x, borrowed_point.y, borrowed_point.z); 


13-3-4 - Le pattern ref 


Lorsque vous vous servez du pattern matching ou de la déstructuration dans une assignation (let), le mot-clé ref 
peut être utilisé pour récupérer une référence d'un (ou plusieurs) champ d'une structure et/ou d'un tuple. Le code ci- 
dessous propose des exemples où ce modèle peut être utile : 


1. #[dérivé(Clone, Copy)] 

2. struct Point { x: i32, y: i32 } 

3. 

4. fn main() { 

5 . let c = ' Q' ; 

6 . 

7. //Un emprunt effectué avec le mot-clé 'ref' (placé dans la 1-value) 

8. // est équivalent à une assignation "C-like" avec le 'S' (placé dans la r-value). 

9. let ref ref_cl = c; 

10. let ref_c2 = &c; 

11. 

12. println! ("ref_cl equals ref_c2 : {}", *ref_cl == *ref_c2); 

13. 

14. let point = Point { x: 0, y: 0 }; 

15. 

16. // 'ref' peut également être utilisé lors de la déstructuration 

17. // d'une structure (aussi valable pour les tuples(structures et littéraux)). 

18. let _copy_of_x = { 

19. // 'ref_to_x' est une référence du champ 'x' contenu dans 

20. // l'instance 'point'. 

21. let Point { x: ref ref_to_x, y: _ } = point; 

22 . 

23. // Renvoie une copie du champ 'x' de l'instance 'point'. 

24. *ref_to_x 

25. } ; 

26. 

27. // Copie mutable de l'instance 'point'. 

28. let mut mutable_point = point; 

29. 

30. { 

31. // 'ref' peut être combiné avec 'mut' pour récupérer 

32. // une référence mutable. 

33. let Point { x: y: ref mut mut_ref_to_y } = mutable_point; 

34. 

35. // On modifie le champ 'y' de l'instance 'mutable_point' par 
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36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 


//le biais de la référence mutable qu'on a récupéré. 
*mut_ref_to_y = 1 ; 


println! ("point is ({}, {})", point.x, point.y); 

println !( "mutable_point is ({}, {})", mutable_point.x, mutable_point.y); 


// Un tuple mutable qui contient un pointeur et un entier non-signé 
// codé sur 32 bits. 

let mut mutable_tuple = (Box: :new(5u32), 3u32); 


{ 

// Nous déstructurons le tuple 'mutable_tuple' pour modifier 
// la valeur de 'last' (dernière élément indexé par le tuple). 
let (_, ref mut last) = mutable_tuple; 

*last = 2u32; 

// est ajouté dans la valeur de gauche car on ne souhaite 

// pas en récupérer le contenu. 

} 


println !( "tuple is {:?}", mutable_tuple); 


13-4 - Système de durée de vie 


Une « lifetime » est une construction utilisée par le compilateur pour s'assurer que tous les emprunts (i.e. références 
immuables/mutables) sont valides. Plus précisément, la durée de vie d'une variable commence lorsqu'elle est créée 
et se termine une fois cette dernière détruite. 


Note : Bien que les lifetimes et les contextes soient très souvent cités ensembles cela reste, malgré tout, deux 
concepts bien distincts. 


1. 

// 

La création et destruction des lifetimes sont illustrées 

ci- 

dessous par des lignes. 

2 . 

// 

'i' possède la plus grande lifetime car son contexte englobe 


3. 

// 

'borrowl' et 'borrow2'. La durée de vie de 'borrowl' ne peut 

pas être 

4 . 

// 

comparée à celle de 'borrow2' car elle ne se trouve pas dans 

le 

5. 

// 

même contexte. 



6. 

fn 

main() { 



7 . 


let i = 3; // Lifetime for 'i' starts. - 



8. 


// 



9. 


{ // 



10 


let borrowl = &i; // 'borrowl' lifetime starts. - 




11 


/ / 




12 


println! ("borrowl: {} " , borrowl); // 




13 


} // 'borrowl ends. - 




14 


// 



15 


// 



16 


{ // 



17 


let borrow2 = &i; // 'borrow2' lifetime starts. - 




18 


// 




19 


println! ("borrow2: {}" , borrow2); // 




20 


} // 'borrow2' ends. - 




21 


// 



22 

} 

// Lifetime ends. - 




Notez qu'aucun nom ou type n'est assigné aux labels de lifetimes. Nous allons apprendre, dans la prochaine section, 
à nous servir des durées de vie (et appréhender l'utilisation des labels). 


13-4-1 - Les labels 


Le compilateur se sert des « annotations explicites » (labels) pour déterminer la durée de validité d'une référence. 
Dans le cas où les lifetimes ne peuvent pas être omises (note : Elles peuvent l'être grâce au concept d'élision), 
Rust dispose d'annotations explicites (labels) pour déterminer quelle devrait être la durée de vie d'une référence. Les 
labels sont précédés d'une 'apostrophe : 
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foo< ' a> 

// 'foo' dispose de la durée de vie ''a'. 

Tout comme les closures, pour utiliser les labels, vous devrez avoir recours à la généricité. De plus, cette syntaxe 
permet de préciser que la durée de vie de foo ne peut pas excéder celle de a. 

Voici la syntaxe des labels lorsqu'ils sont appliqués à un type : &'a T (ou &'a mut T) où 'a est un label déclaré près 
de l'identificateur de la fonction. 

Si vous devez déclarer plusieurs lifetimes, la syntaxe est tout aussi simple : 


foo< ' a, 

1 b> 



| // 'foo* 

dispose des lifetimes 

''a' et 

' ’b' . 


Dans ce cas, la durée de vie de foo ne peut pas excéder la lifetime 'a ou 'b. 


1 . // 'print_refs' prend deux références d'entiers possédant une durée de 

2. // vie différente chacune (i.e. ~'a' et "'b'). Ces deux lifetimes doivent être 

3. // au moins aussi longues que celle de la fonction 'print_refs'. 

4. fn print_refs < 1 a, 'b>(x: & 'a i32, y: &'b i32) { 

5. println!("x is {} and y is {}", x, y); 

6 . } 

7 . 

8 . // Une fonction qui ne prend aucun argument, mais qui déclare quand même 

9. // une lifetime "'a'. 

10 . fn failed_borrow< 1 a>() { 

11 . let _x = 12; 

12 . 

13. // ERREUR: x ne vit pas assez longtemps. 

14. // let y: & 1 a i32 = &_x; 

15. // Tenter d'utiliser la lifetime '’a' sur une ressource au sein de la fonction 

16. // ne fonctionnera pas car la durée de vie de '&_x' est plus courte que celle 

17. // de "y . 

18. // Une courte durée de vie ne peut être rallongée en cours de route. 

19. 1 

20 . 

21 . fn main() { 

22. // On crée ces variables pour les emprunter 

23. // un peu plus bas. 

24. let (four, nine) = (4, 9); 

25. 

26. // 'print_refs' emprunte ('&') les deux ressources précédemment 

27. // créées. 

28. print_refs(Sfour, &nine); 

29. // Une ressource empruntée doit survivre à la fonction qui l'emprunte. 

30. // Autrement dit, la durée de vie de 'four' et 'nine' doit être 

31. // plus longue que celle de 'print_refs'. 

32. 

33. failed_borrow(); 

34. 

35. // 'failed_borrow' ne contient aucune référence qui force la lifetime ' 1 a' à 

36. // être plus longue que celle de la fonction, mais "'a' reste plus longue. 

37. // Parce que la durée de vie d’une ressource (empruntée) n’est jamais imposée, 

38. // la durée de vie par défaut est "'static'. 

39. } 


Voir aussi 

La généricité et les closures. 


13-4-2 - Les fonctions 


Lorsque le concept d'élision ne peut pas être appliqué, les signatures de fonctions comportant des (labels de) 
lifetimes sont régies par quelques règles : 
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1 Toute référence doit être annotée d'une lifetime ; 

2 Toute référence renvoyée doit posséder la même lifetime qu'en entrée ou la lifetime 'static. 

Notez également que, si une fonction n'a pas de références en entrée, le renvoi de références est interdit car cela 
pourrait conduire à l'utilisation de ressources invalides. 


1. // La référence passée en paramètre possédant la lifetime ~'a' 

2. // doit vivre au moins aussi longtemps que le fonction. 

3. fn print_one< 1 a>(x: & 1 a i32) { 

4. println !("’print_one’: x is {}", x) ; 

5. } 

6 . 

7. // L'utilisation des références mutables est également possible 

8. // avec les lifetimes. 

9. fn add_one< ' a>(x: &'a mut i32) { 

10 . *x += 1; 

11 . } 

12 . 

13. // Plusieurs entrées avec différentes lifetimes. Dans ce cas, 

14. // il serait plus simple, pour les deux paramètres, d'avoir 

15. // la même durée de vie ( ' ' a'), mais dans des cas plus délicats, 

16. // plusieurs lifetimes peuvent être requises. 

17. fn print_multi< ' a, 'b>(x: & 'a i32, y: &'b i32) { 

18. println !("'print_multi': x is {}, y is {}", x, y); 

19. } 

20. 

21. // Renvoyer des références qui ont été passées en paramètre est légal. 

22. // Toutefois, veillez à renvoyer la bonne lifetime. 

23. fn pass_x<'a, 'b>(x: &'a i32, &'b i32) -> & 'a i32 { x } 

24 . 

25. // fn invalid_output<'a>() -> &'a i32 { &7 } 

26. // La déclaration ci-dessus est invalide: ~'a' doit, au moins, 

27. // survivre à la fonction. Ici, '&7' créerait un entier et récupérerait 

28. // sa référence. La ressource serait alors perdue une fois l'exécution 

29. // de la fonction terminée, renvoyant une référence d'une ressource qui n'existe plus. 

30. 

31. fn main ( ) { 

32. let x = 7; 

33. let y = 9; 

34. 

35. print_one(&x); 

36. print_multi(&x, &y); 

37. 

38. let z = pass_x(Sx, &y); 

39. print_one(z); 

40. 

41. let mut t = 3 ; 

42. add_one(&mut t) ; 

43. print_one(&t); 

44. } 


Voir aussi 
Les fonctions. 


13-4-3 - Les méthodes 


Les méthodes sont annotées de la même manière que les fonctions : 


1. struct Owner(i32); 

2 . 

3 . impi Owner { 

4. //On déclare et annote les lifetimes comme 

5. // dans une fonction traditionnelle. 

6. fn add_one< ' a> ( & ' a mut self) { self.O += 1; } 

7. fn print< ' a> ( & ' a self) { 
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8 . println! (" 'print': {}", self.O); 

9. } 

10 . } 

11 . 

12 . fn main ( ) { 

13. let mut owner = Owner(18); 

14 . 

15. owner.add_one(); 

16. owner. print () ; 

17. } 


Voir aussi 
Les méthodes. 


13-4-4 - Les structures 


La déclaration des labels pour les structures ne diffère pas beaucoup non plus de celle des fonctions : 


1. // On créé un type nommé 'Borrowed' qui a pour attribut 

2. // une référence d'un entier codé sur 32 bits. La référence 

3. // doit survivre à l'instance de la structure 'Borrowed'. 

4. #[dérivé(Debug)] 

5. struct Borrowed< ' a>(& 'a i32); 

6 . 

7. // Même combat, ces deux références doivent survivre à l'instance 

8 . // (ou aux instances) de la structure 'NamedBorrowed'. 

9. #[dérivé(Debug)] 

10. struct NamedBorrowed< ' a> { 

11. x: &'a i32, 

12. y: & 'a i32, 

13. } 

14. 

15. //On créé une énumération qui contient deux variantes : 

16. // 1. Un tuple qui prend en entrée un entier codé sur 32 bits; 

17. // 2. Un tuple qui prend en entrée une référence d'un 'i32'. 

18. #[dérivé(Debug)] 

19. enum EitherCa> { 

20. Num(i32), 

21. Ref(& 'a i32), 

22 . } 

23. 

24. fn main() { 

25. let x = 18; 

26. let y = 15; 

27. 

28. let single = Borrowed(&x); 

29. let double = NamedBorrowed { x: &x, y: & y }; 

30. let reference = Either: :Ref(&x); 

31. let number = Either::Num(y); 

32. 

33. println! ("x is borrowed in {:?}", single); 

34. println! ("x and y are borrowed in {:?}", double); 

35. println! ("x is borrowed in {:?}", reference); 

36. println! ("y is *not* borrowed in {:?}", number); 

37. } 


Voir aussi 

Les structures. 
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13-4-5 - Les restrictions 


Tout comme les types génériques, les lifetimes (elles-mêmes génériques) utilisent les restrictions. Ici, le caractère : 
a une signification quelque peu différente, mais + possède la même fonction. La déclaration se lit comme suit : 

1 T: 'a : Toutes les références dans le type T doivent, au moins, survivre à la lifetime a ; 

2 T: Trait + 'a : Le type T doit implémenter le trait Trait et toutes les références doivent survivre à la lifetime 'a. 

L'exemple ci-dessous illustre les explications précédentes : 


1. use std::fmt: :Debug; / On importe le trait 'Debug'. 

2. // Trait avec lequel nous allons filtrer les entrées 

3. // des fonctions génériques. 

4 . 

5. # [dérivé(Debug)] 

6. struct Ref<’a, T: 'a>(&'a T); 

7. // 'Ref' contient la référence d’un type générique 'T' qui possède 

8. // une lifetime inconnue nommée ''a'. Toutes les références contenues par 

9. // le type 'T' sont contraintes à survivre à la lifetime ''a'. De plus, 

10. // la durée de vie de 'Ref' ne peut pas excéder la lifetime ''a'. 

11. 

12. // Une fonction générique qui affiche le résultat de l'utilisation 

13. // du trait "Debug . 

14. fn print<T>(t: T) where 

15. T: Debug { 

16. println! ("'print ' : t is {:?}", t) ; 

17. } 

18. 

19. // Ici, nous avons une référence de type 'T' en entrée où 

20. // 'T' implémente le trait 'Debug' et toutes les références 

21. // contenues par le type 'T' survivent à la lifetime 'a'. La lifetime 

22. // "'a' doit survivre à l'appel de la fonction. 

23. fn print_ref< ' a, T>(t: & ' a T) where 

24. T: Debug + 'a { 

25. println! ("'print_ref ' : t is {:?}", t); 

26. } 

27 . 

28. fn main() { 

29. let x = 7; 

30. let ref_x = Ref(Sx); 

31. 

32. print_ref(Sref_x); 

33. print(ref_x); 

34. } 


Voir aussi 

La généricité, les restrictions et les restrictions multiples. 


13-4-6 - La coercition 


Une longue durée de vie peut être raccourcie afin d'opérer dans un contexte où elle ne fonctionnerait pas en temps 
normal. Cette opération peut être effectuée par inférence du compilateur ou en déclarant une différence de durée de 
vie(e.g. l'une est, au moins, aussi longue que l'autre, sinon plus). 

1. // Ici, Rust va inférer une durée de vie aussi courte que possible. 

2. // Les deux références sont alors assignées à cette durée de vie. 

3. fn multiplyC ' a> ( f irst: &'a i32, second: &'a i32) -> i32 { 

4 . first * second 

5. } 

6 . 

7. // 'c'a: 'b, 'b>' se lit comme suit: La lifetime v, a' est au moins aussi longue 

8. // que '*b'. Ici, nous prenons en entrée un entier soumis à la lifetime 

9. // '&'a i32' et renvoyons un entier (le même entier, en fait) soumis à la lifetime 
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10 . 

// 

11 . 

// 

12 . 

// 

13. 

// 

14 . 

fn 

15. 


16. 

} 

17 . 


18. 

fn 

19. 


20 . 


21 . 


22 . 


23. 


24 . 


25. 


26. 


27 . 


28. 

} 


’&'b i32' comme résultat de la coercition. 

Note: Nous pouvons renvoyer l'entier taggé avec la lifetime "'b" car "'a' et ''b' 
ont une durée de vie aussi longue, pour le temps de l'exécution de la fonction, 
tout du moins. 

choose_firstc 'a : 'b, 'b>(first: &'a i32, &'b i32) -> &'b i32 { 

f irst 


main() { 

let first = 2; // Longue lifetime. 

{ 

let second =3; // Courte lifetime. 

// Note: Ici 'first' et 'second' possèdent la même durée de vie. 
println! ( "The product is {}", multiply(Sfirst, Ssecond)); 
println!("{} is the first", choose_first(Sfirst, Ssecond)); 

} ; 


13-4-7 - La lifetime 'static 


Une ressource annotée du label ’static possède la plus longue durée de vie qu'on puisse assigner. La durée de vie 
de ’static est égale à celle du programme lui-même et peut également être raccourcie selon le contexte. 

Il y a deux façons d'assigner la lifetime ’static, et toutes deux stockeront la ressource directement dans le binaire 
en lecture seule : 

1 Créer une constante avec la déclaration static ; 

2 Créer une chaîne de caractères avec le "littéral" en l'annotant du type &'static str. 

Voici un exemple pour illustrer les deux manières de faire : 


1. // On créé une constante avec la lifetime "'static' en utilisant 

2 . // le mot-clé 'static'. 

3. static NUM: i32 = 18; 

4 . 

5. // Renvoie une référence de 'NUM' où sa lifetime ''static' 

6 . // est obligée de s'aligner avec la durée de vie du paramètre 

7. // passé à la fonction. 

8 . fn coerce_static< ' a> (_: & ' a i32) -> & ' a i32 { 

9. &NUM 

10 . } 

11 . 

12 . fn main() { 

13. { 

14. // On créé une chaîne de caractères littérale, primitive 

15. // et on l'affiche. 

16. let static_string = "I'm in read-only memory" ; 

17. println! ("static_string: {}", static_string); 

18. 

19. // Lorsque 'static_string' sortira du contexte, la référence 

20 . // ne pourra plus être utilisée, mais la ressource restera 

21 . // présente dans le binaire. 

22 . } 

23. 

24. { 

25. 

26. 

27 . 

28. 

29. // On aligne, adapte la durée de vie de 'NUM à 

30. // celle de 'lifetime_num': 

31. let coerced_static = coerce_static(&lifetime_num); 

32. 

33. println! ("coerced_static: {}", coerced_static); 

34. } 


// On créé un entier à passer à la 
// fonction 'coerce_static': 
let lifetime num = 9; 
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35. 

36. println! ("NUM: {} stays accessible!", NUM); 

37. } 


Voir aussi 

Les constantes. 


13-4-8 - Annotation implicite 


En règle générale, décrire explicitement la durée de vie d'une référence n'est pas nécessaire et nous préférerons 
passer la main au compilateur, qui se chargera de nous épargner l'écriture des annotations et d'améliorer la lisibilité 
du code. Ce processus d'annotation implicite se nomme l'élision. Il s'agit ici d'omettre volontairement les annotations 
pour que le compilateur le fasse à notre place. L'élision ne peut être appliquée que lorsqu'un pattern de durée de 
vie est commun, simple à deviner. 

Le code source qui suit présente quelques exemples où nous avons volontairement omis les annotations. Pour une 
description plus exhaustive du concept d'élision, n'hésitez pas à consulter la section lifetime élision du livre. 


1 . // 'elided_input' et 'annotated_input' ont fondamentalement la même signature, 

2 . // sauf que la lifetime de l'entrée de la fonction 'elided_input' a été omise 

3. //et ajoutée par le compilateur. 

4. fn elided_input(x: Si32) { 

5. println !(" 'elided_input': {}", x) 

6 . } 

7 . 

8 . fn annotated_input< 1 a> (x: & 1 a i32) { 

9. println! (" 'annotated_input' : {}", x) 

10 . } 

11 . 

12. // Même combat, 'elided_pass' et 'annotated_pass' possèdent la même signature 

13. // sauf que la lifetime de 'x', pour la fonction 'elided_pass', a été omise 

14. // et ajoutée par le compilateur. Annotation implicite. 

15. fn elided_pass(x: Si32) -> &i32 { x } 

16. 

17. fn annotated_pass< 1 a> (x: & 1 a i32) -> & 1 a i32 { x } 

18. 

19. fn main() { 

20. let x = 3; 

21 . 

22 . elided_input(&x); 

23. annotated_input(Sx); 

24 . 

25. println !("' elided_pass ' : {}", elided_pass ( Sx) ) ; 

26. println !("' annotated_pass' : {}", annotated_pass(Sx)); 

27. } 


Voir aussi 

Le chapitre du livre sur l'élision. 


14 - Les traits 


Un trait est un agrégat de méthodes définies pour un type inconnu : Self. Elles peuvent accéder aux autres méthodes 
déclarées dans le même trait. 

Les traits peuvent être implémentés pour n'importe quel type de donnée. Dans l'exemple ci-dessous, nous définissons 
Animal, un groupe de méthodes. Le trait Animal est alors implémenté pour le type Sheep, permettant l'utilisation des 
méthodes de Animal avec une instance du type Sheep. 

1. struct Sheep { naked: bool, name: S'static str } 
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2 . 

3. 

trait Animal { 


4 . 


// Méthode statique; 'Self' fait référence au type ayant implémenté 

5. 


// le trait. 


6. 

n 


fn new(name: & 1 static str) -> Self; 


/ . 

8. 


// Méthode d'instance; Elles renverront une chaîne de caractères. 


9. 


fn name(Sself) -> &'static str; 


10 


fn noise (Sself) -> &'static str; 


11 




12 


// Les traits peuvent fournir une implémentation par défaut. 


13 


fn talk(Sself) { 


14 


println!("{} says {}", self.nameO, self .noise()); 


15 


} 


16 

} 



17 




18 

impi Sheep { 


19 


fn is naked(Sself) -> bool { 


20 


self .naked 


21 


} 


22 




23 


fn shear(&mut self) { 


24 


if self.is nakedO { 


25 


// Les méthodes de 'Self' peuvent utiliser les méthodes 

déclarées 

26 


// par le trait. 


27 


println!("{} is already naked...", self.nameO); 


28 


} else { 


29 


println!("{} gets a haircut!", self. name); 


30 




31 


self. naked = true; 


32 


} 


33 


} 


34 

} 



35 




36 

// 

Implémentation des services du trait 'Animal' 


37 

// 

pour le type 'Sheep'. 


38 

impi Animal for Sheep { 


39 


// En l’occurrence, 'Self' fait référence à 'Sheep'. 


40 


fn new(name: &'static str) -> Sheep { 


41 


Sheep { name: name, naked: false } 


42 


} 


43 




44 


fn name(Sself) -> &'static str { 


45 


self .name 


46 


} 


47 




48 


fn noise (Sself) -> &'static str { 


49 


if self.is nakedO { 


50 


"baaaaah?" 


51 


} else { 


52 


"baaaaah!" 


53 


} 


54 


} 


55 




56 


// L'implémentation par défaut fournie par le trait 


57 


// peut être réécrite. 


58 


fn talk(Sself) { 


59 


// Par exemple, nous pourrions fournir une description plus 

précise. 

60 


println!("{} pauses briefly... {}", self. name, self .noise ()) 

; 

61 


} 


62 

} 



63 




64 

fn 

main() { 


65 


// Typer l'identificateur est nécessaire dans ce cas de figure. 


66 


let mut dolly: Sheep = Animal::new( "Dolly" ); 


67 


// TODO A Essayez de supprimer le type annoté. 


68 




69 


dolly.talk(); 


70 


dolly.shear(); 


71 


dolly.talk(); 


72 

} 
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14-1 - L'attribut Dérivé 


Le compilateur est capable de fournir de simples implémentations pour cetains traits parle biais de l'attribut #[derive]. 
Ces traits peuvent toujours être implémentés manuellement si un traitement plus complexe est attendu. 

Voici une liste de traits pouvant être dérivés : 

• Les traits de comparaison : Eq, PartialEq, Ord, PartialOrd; 

• Clone, pour créer une instance (T) à partir d'une référence (&T) par copie ; 

• Copy, pour permettre à un type d'être copié plutôt que transféré ; 

• Hash, pour générer un hash depuis &T ; 

• Debug, pour formater une valeur en utilisant le formatteur {:?}. 


1. // 'Centimeters' est un tuple qui peut être comparé. 

2. # [dérivé(PartialEq, PartialOrd)] 

3. struct Centimeters(f64); 

4 . 

5. // 'Inches' est un tuple qui peut être affiché. 

6. # [dérivé(Debug)] 

7. struct Inches(i32); 

8. 

9. impi Inches ( 

10. fn to_centimeters (&self ) -> Centimeters ( 

11. let sinches(inches) = self; 

12 . 

13. Centimeters(inches as f64 * 2.54) 

14. } 

15. } 

16. 

17. // 'Seconds' est un tuple ne possédant aucun attribut. 

18. struct Seconds(132); 

19. 

20. fn main() { 

21. let onesecond = Seconds(1); 

22 . 

23 . // Erreur; 'Seconds' ne peut pas être affiché; Il n’implémente pas le trait 'Debug'. 

24 . // println! ("One second looks like; {:?}", _one_second); 

25. // TODO A Essayez de décommenter cette ligne. 

26. 

27 . // Erreur; 'Seconds' ne peut pas être comparé; Il n’implémente pas le trait 'PartialEq'. 

28 . // let _this_is_true = (_one_second == _one_second); 

29. // TODO A Essayez de décommenter cette ligne. 

30. 

31. let foot = Inches(12); 

32. 

33. println! ("One foot equals (:?}", foot); 

34. 

35. let meter = Centimeters (100 .0); 

36. 

37. let cmp = 

38. if foot.to_centimeters() < meter { 

39. "smaller" 

40. } else ( 

41. "bigger" 

42. } ; 

43. 

44. println! ("One foot is {} than one meter.", cmp) ; 

45. } 


Voir aussi 
Dérivé. 
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14-2 - La surcharge des opérateurs 


Avec Rust, nombre d'opérateurs peuvent être surchargés via les traits. En d'autres termes, des opérateurs peuvent 
être utilisés pour accomplir différentes tâches en fonction des arguments passés en entrée. Cette manipulation est 
possible parce que les opérateurs sont des sucres syntaxes visant à masquer l'appel des méthodes liées à ces 
derniers. Par exemple, l'opérateur + dans l'expression a + b appelle la méthode add (a.add(b)). La méthode add 
appartient au trait Add, d'où l'utilisation de l'opérateur + par tous les types implémentant le trait. 

Vous pouvez retrouver la liste des traits surchargeant des opérateurs [ici][operators]. 


I. use std::ops; 

2 . 

3. struct Foo; 

4. struct Bar; 

5. 

6. #[dérivé(Debug)] 

7. struct FooBar; 

8 . 

9. #[dérivé(Debug)] 

10. struct BarFoo; 

II. 

12. // Le trait 'std::ops::Add' est utilisé pour permettre la surcharge de 

13. // Ici, nous spécifions 'Add<Bar>' - cette implémentation sera appelée 

14. // de type 'Bar'. 

15. // Le bloc ci-dessous implémente l'opération : 'Foo + Bar = FooBar'. 

16. impi ops: :Add<Bar> for Foo ( 

17. type Output = FooBar; 

18. 

19. fn add(self, _rhs: Bar) -> FooBar ( 

20. println! ("> Foo.add(Bar) was called"); 

21. 

22. FooBar 

23. } 

24. } 

25. 

26. // En inversant les types, nous nous retrouvons à implémenter une addition non-commutative. 

27. // Ici, nous spécifions 'Add<Foo>' - cette implémentation sera appelée si l'opérande de droite 

28. // est de type 'Foo'. 

29. // Le bloc ci-dessous implémente l'opération: 'Bar + Foo = BarFoo'. 

30. impi ops: :Add<Foo> for Bar ( 

31. type Output = BarFoo; 

32. 

33. fn add(self, _rhs: Foo) -> BarFoo ( 

34. println! ("> Bar.add(Foo) was called"); 

35. 

36. BarFoo 

37. } 

38. } 

39. 

40. fn main() { 

41. println !( "Foo + Bar = (:?}", Foo + Bar); 

42. println !( "Bar + Foo = (:?}", Bar + Foo); 

43. } 


' + ' . 

si l'opérande de droite est 


Voir aussi 


Add, index de la syntaxe. 


14-3 - Le trait Drop 


Le trait Drop ne possède qu'une seule méthode : drop ; cette dernière est automatiquement appelée lorsqu'un objet 
sort du contexte. La fonction principale du trait Drop est de libérer les ressources que les instances, du type ayant 
implémenté le trait, possèdent. 
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Box, Vec, String, File et Process sont autant d'exemples de types qui implémentent le trait Drop pour libérer leurs 
ressources. Le trait Drop peut également être implémenté manuellement pour répondre aux besoins de vos propres 
types. 

Dans l'exemple suivant, nous affichons quelque chose dans la console à partir de la méthode drop pour notifier 
chaque appel. 


1. 

struct Droppable { 



2 . 

3. 

name: & ' static str, 

} 



4 . 

5. 

// Implémentation basique de "drop" qui affiche 

un message dans 

la console. 

6. 

impi Drop for Droppable { 



7 . 

fn drop(&mut self) { 



8. 

println! ("> Dropping {}", self. name); 



9. 

} 



10 

. } 



11 




12 

. fn main() { 



13 

let a = Droppable { name: "a" }; 



14 




15 

// block A 



16 

{ 



17 

let b = Droppable { name: "b" }; 



18 




19 

// block B 



20 

{ 



21 

let c = Droppable { name: "c" }; 



22 

let d = Droppable { name: "d" }; 



23 




24 

println! ("Exiting block B"); 



25 

} 



26 

. println! ("Just exited block B"); 



27 




28 

. println! ("Exiting block A"); 



29 

} 



30 

. println! ("Just exited block A"); 



31 




32 




// La variable peut être libérée manuellement en 

utilisant la fonction (std::mem::)drop'. 

33 

drop( a); 



34 

. // TODO A Essayez de commenter cette ligne 



35 




36 

. println! ("end of the main function"); 



37 




38 

. // ' a' ne *sera pas* libérée une seconde 

fois ici puisque 

nous l'avons déjà fait 

39 

. // plus haut, manuellement. 



40 

. } 




14-4 - Les itérateurs 


Le trait Iterator est utilisé pour implémenter les itérateurs sur les collections tels que les tableaux. 


Le trait nécessite seulement la définition d'une méthode pour l'élément next. Elle peut être implémentée manuellement 
en utilisant un bloc impi ou automatiquement (comme pour les tableaux et intervalles). 

Pour les utilisations les plus communes, la boucle for peut convertir certaines collections en itérateurs en utilisant 
la méthode .into_iterator(). 

Les méthodes pouvant être appelées en utilisant le trait Iterator, en plus de celles présentées dans l'exemple ci- 
dessous, sont listées ici. 

1. struct Fibonacci { 

2. curr: u32, 

3. next: u32. 
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4. } 

5. 

6. // Implémentation de 'Iterator' pour le type 'Fibonacci'. 

7. // Le trait 'Iterator' nécessite l'implémentation d'une méthode seulement pour l'élément 'next'. 

8. impi Iterator for Fibonacci { 

9. type Item = u32; 

10 . 

11. // Ici, nous définissons la séquence utilisant '.curr' et '.next'. 

12. //Le type de renvoi est 'Option<T>': 

13. // * Lorsque 1''Iterator' est terminé, 'None' est renvoyé; 

14 . 

// * Autrement, la valeur suivante est enveloppé dans une instance 'Some' et renvoyée. 

15. fn next(Smut self) -> Option<u32> { 

16. let newnext = self. curr + self. next; 

17 . 

18. self. curr = self. next; 

19. self. next = newnext; 

20 . 

21. // Puisqu'il n'y a pas de limite à une suite de Fibonacci, 1''Iterator' 

22. // ne renverra jamais 'None'. 

23. Some (self .curr) 

24. } 

25. } 

26. 

27. // Renvoie un générateur de suites de Fibonacci. 

28. fn fibonacci() -> Fibonacci { 

29. Fibonacci { curr; 1, next: 1 } 

30. } 

31. 

32. fn main() { 

33. // '0..3' est un 'Iterator' qui génère: 0, 1, et 2 (i.e. intervalle '[0, 3['). 

34. let mut sequence = 0..3; 

35. 

36. println! ("Four consecutive 'next' calls on 0..3"); 

37. println! ("> {:?}", sequence. next ()) ; 

38. println! ("> {:?}", sequence.next()); 

39. println! ("> {:?}", sequence.next()); 

40. println! ("> {:?}", sequence.next()); 

41. 

42 . 

43. // 'for' parcourt un 'Iterator' jusqu'à ce qu'il renvoie 'None'. 

44. // Chaque valeur contenue par un objet 'Some' est libérée de son conteneur 

45. // puis assignée à une variable (en l’occurrence, 'i'). 

46. println! ("Iterate through 0..3 using 'for'"); 

47. for i in 0 .. 3 { 

48. println! ("> {}", i); 

49. } 

50. 

51. // La méthode 'take(n) ' réduit un 'Iterator' à ces 'n' premiers éléments. 

52. println! ("The first four terms of the Fibonacci sequence are: "); 

53. for i in f ibonacci (). take (4 ) { 

54. println! ("> {}", i); 

55. } 

56. 

57. // La méthode 'skip(n)' tronque les 'n' premiers éléments d'un 'Iterator'. 

58. println! ("The next four terms of the Fibonacci sequence are: "); 

59. for i in f ibonacci (). skip (4 ). take (4 ) { 

60. println! ("> {}", i); 

61. } 

62. 

63. let array = [lu32, 3, 3, 7]; 

64. 

65. // La méthode 'iter' construit un 'Iterator' sur un(e) tableau/slice. 

66. println! ("Iterate the following array {:?}", Sarray); 

67. for i in array.iter() { 

68. println! ("> {}", i); 

69. } 

70. } 
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14-5 - Le trait Clone 


Lors du traitement des ressources, le comportement par défaut est de les transférer lors d'un assignement ou un 
appel de méthode. Cependant, il est parfois nécessaire d'effectuer une copie des ressources en question. 

C'est exactement la fonction du trait Clone, qui nous permettra d'utiliser la méthode cloneQ. 


1. // Une structure unitaire sans ressources. 

2. #[dérivé(Debug, Clone, Copy)] 

3. struct Nil; 

4 . 

5. // Un tuple avec des ressources qui implémente le trait 'Clone'. 

6. #[dérivé(Clone, Debug)] 

7. struct Pair(Box<i32>, Box<i32>); 

8. 

9. fn main() { 

10. // Un instancie 'Nil'. 

11. let nil = Nil; 

12 . // On copie l'objet 'Nil', aucune ressource à transférer. 

13. let copied_nil = nil; 

14 . 

15 . // Les deux instances peuvent être utilisées indépendament l'une de l'autre. 

16. println !( "original : (:?}", nil); 

17. println! ("copy: (:?}", copied_nil); 

18. 

19. //On crée un objet 'Pair'. 

20. let pair = Pair(Box::new(1), Box : : new (2 ) ) ; 

21. println !( "original : (:?}", pair); 

22 . 

23 . // On copie 'pair' dans 'moved_pair ', transfert de ressources. 

24. let moved_pair = pair; 

25. println! ("copy: (:?}", moved_pair); 

26. 

27 . // Erreur! 'pair' ne possède plus ses ressources. 

28. // println!("original : {:?}", pair); 

29. // TODO A Essayez de décommenter cette ligne. 

30. 

31 . // On copie 'moved_pair' dans 'cloned_pair' (ressources incluses). 

32. let cloned_pair = moved_pair.clone(); 

33 . // On libère la ressource originale avec 'std: :mem:: drop'. 

34. drop(moved_pair); 

35. 

36. // Erreur! 'moved_pair' a été libérée. 

37. // println!("copy: {:?}", moved_pair); 

38. // TODO A Essayez de décommenter cette ligne. 

39. 

40. // La copie obtenue par '.clone()' peut toujours être utilisée ! 

41. println! ("clone: (:?}", cloned_pair); 

42. } 


15-macro rules! 


Rust fournit un puissant système de macros qui permet la métaprogrammation. Comme vous l'avez vu dans les 
chapitres précédents, les macros ressemblent aux fonctions, excepté que leurs identificateurs se terminent par un 
point d'exclamation !, mais au lieu de générer un appel de fonction, les macros sont étendues dans le code source 
et compilées avec le reste du programme. 

Il est possible de créer une macro en utilisant la macro macro_rules!. 


1. // Une simple macro nommée 'say_hello'. 

2. macro_rules! say_hello { 

3. //'()' indique que la macro ne prend aucun argument. 

4. 0 => ( 

5. //La macro étendra le contenu de ce bloc. 

6. println! ( "Hello!" ); 
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7 . 
8 . 

9. 

10 . 
11 . 
12 . 
13. 


} 


fn main() { 

// Cet appel va étendre "println! ("Hello");'. 
say_hello ! ( ) 



15-1 

- Les indicateurs 


Les arguments d'une macro sont préfixés par un $ et sont typés par le biais d'un indicateur : 

1. macro rules! create function { 


2 . 

// Cette macro prend un argument possédant l'indicateur 'ident' 


3. 

// et créé une fonction nommée '$func name ' . 


4 . 

// L'indicateur "ident" est utilisé pour les identificateur de variables/fonctions. 

5. 

($func name:ident) => ( 


6. 

fn $func name () { 


7 . 

// La macro "stringify!" convertit un "ident" en chaîne de 

caractères. 

8. 

println ! ("You called {:?}()", 


9. 

stringify! ($func name)) 


10. 

} 


11. 

) 


12 . 

} 


13. 



14 . 

// On créé les fonctions "foo" et "bar" avec la macro ci-dessus. 


15. 

create function ! (foo) ; 


16. 

create function ! (bar ) ; 


17 . 



18. 

macro rules ! print resuit { 


19. 

// Cette macro prend une expression de type "expr" et 


20. 

// affiche sa représentation sous forme de chaîne de caractères 


21. 

// ainsi que son résultat. 


22 . 

($expression :expr ) => ( 


23. 

// "stringify!" va convertir l'expression *telle qu'elle est* 

dans une chaîne 

24 . 

// de caractères. 


25. 

println! ("{:?} = {:?}", 


26. 

stringify! ($expression), 


27 . 

$expression) 


28. 

) 


29. 

} 


30. 



31. 

fn main () { 


32. 

foo(); 


33. 

bar(); 


34. 



35. 

print resuit! (Iu32 + 1); 


36. 



37. 

// Rappelez-vous que les blocs sont également des expressions ! 


38. 

print resuit ! ({ 


39. 

let x = lu32; 


40. 



41. 

x*x + 2*x-l 


42 . 

}) ; 


43. 

} 



Voici une liste exhaustive des indicateurs existants : 

• block ; 

• expr, pour les expressions ; 

• ident, pour les identificateurs de variables et fonctions ; 

• item ; 

• pat (pattern) ; 

• path ; 

• stmt (déclaration) ; 

• token (token tree) ; 
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ty (type). 


15-2 - Surcharge 


Les macros peuvent être surchargées pour accepter différentes combinaisons d'arguments. Dans cet esprit, 
macro_rules! peut fonctionner de la même manière qu'un bloc match : 


1. // 'test!' va comparer '$left' et '$right' de différentes 

2. // manières suivant son utilisation à l'invocation: 

3. macrorules! test { 

4. //Il n'est pas nécessaire de séparer les arguments par des virgules. 

5. // N'importe quel modèle peut être utilisé ! 

6. ($left:expr; and $right:expr) => ( 

7. println !("{:?} and {:?} is {:?}", 

8. stringify! ($left), 

9. stringify! ($right), 

10. $left && $right) 

11 . ) ; 

12. // * Chaque branche doit se terminer par un point-virgule. 

13. ($left:expr; or $right:expr) => ( 

14. println! ("{:?} or {:?} is {:?}", 

15. stringify! ($left), 

16. stringify! ($right), 

17. $left II $right) 

18. ) ; 

19. } 

20. 

21. fn main() { 

22. test! (1132 + 1 == 2i32; and 2i32 * 2 == 4i32); 

23. test! (true; or false) ; 

24. } 


15-3 - Répétition 


Les macros peuvent utiliser le quantificateur + dans la liste des arguments pour indiquer qu'un argument peut être 
répété au moins une(1 ) fois ou * pour indiquer que l'argument peut être répété zéro(O) ou plusieurs fois. 

Dans l'exemple suivant, entourer le matcher avec $(...),+ va permettre la capture d'une ou plusieurs expressions, 
séparées par des virgules. Notez également que le point-virgule est optionnel dans le dernier cas (i.e. la dernière 
expression capturée). 


— Il 

'min!' va calculer le minimum entre chaque argument passé, peu importe le nombre. 

2. macro rules! find 

min { 

3. 

// Expression 

de base: 

4 . 

($x:expr) => 

($x) ; 

5. 

// '$x' suivi 

par au moins un '$y, '. 

6. 

( $x :expr, $ ( $y :expr),+) => ( 

7 . 

// On appelle 'find min' sur les $y suivants'. 

8. 

Q 

std::cmp: 

:min($x, find min! ($($y),+)) 

y . 

10. } 

) 


il. 



12. fn 

main 0 { 


13. 

println! ( " {} 

", find min! (Iu32)); 

14 . 

println! ( " {} 

", find min! (Iu32 + 2 , 2u32)); 

15. 

println! ( " {} 

", find min! (5u32, 2u32 * 3, 4u32)); 

16. } 




15-4 - DRY (Don't Repeat Yourself) 


Les macros permettent l'écriture de code DRY en recyclant les parties communes d'un ensemble de fonctions/tests. 
Voici un exemple qui implémente et test les opérateurs +=, *= et -= sur la structure Vec<T> : 
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1 . 
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6 . 
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8 . 
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17 
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26 

27 

28 

29 
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31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 


// Dans le fichier dry.rs 

use std::ops: :{Add, Mul, Sub}; 

macrorules! assert_equal_len { 

// L'indicateur 'tt' (token tree) est utilisé pour les opérateurs 
// et les tokens. 

($a:ident, $b: ident, $func:ident, $op:tt) => ( 
assert ! ($a. len ( ) == $b.len(), 

"{:?}: dimension mismatch: {:?} {:?} {:?}", 
stringify! ($func), 

($a.len ( ),), 
stringify! ($op), 

($b. len (),)); 


) 


} 


macro_rules! op { 

($func :ident, $bound:ident, $op:tt, $method: ident) => ( 

fn $func<T: $bound<T, Output=T> + Copy>(xs: &mut Vec<T>, ys : &Vec<T>) { 
assert_equal_len! (xs, ys, $func, $op); 

for (x, y) in xs.iter_mut().zip(ys.iter()) { 

*x = $bound:: $method (*x, *y); 

// *x = x. $method (*y) ; 

} 


} 

// On implémente les fonctions 'add_assign', 'mul_assign' et 'sub_assign'. 

op! (add_assign, Add, +=, add) ; 
op! (mul_assign, Mul, *=, mul); 
op! (sub_assign, Sub, -=, sub) ; 

mod test { 

use std::iter; 
macrorules! test { 

($func: ident, $x:expr, $y:expr, $z:expr) => { 

#[test] 
fn $func() { 

for size in Ousize..lO { 

let mut x: Vec<_> = iter::repeat($x).take(size).collect() , 
let y: Vec<_> = iter::repeat( $ y ).take(size).collect(); 
let z: Vec<_> = iter::repeat($z).take(size).collect(); 

super:: $func (&mut x, Sy); 

assert_eq! (x, z); 


// Test de 'add_assign', 'mul_assign' 
test ! (add_assign, lu32, 2u32, 3u32); 
test ! (mul_assign, 2u32, 3u32, 6u32); 
test ! (sub_assign, 3u32, 2u32, lu32); 


et 'sub_assign'. 


1. 

$ rustc -- 

-test dry.rs && . 

. /dry 

2 . 

running 3 

tests 


3. 

test test: 

::mul assign .. . 

ok 

4 . 

test test: 

: :add assign ... 

ok 

5. 

C 

test test: 

: :sub assign ... 

ok 

O . 

7 . 

test resuit: ok. 3 passed; 

: 0 failed; 0 ignored; 0 measured 
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16 - La gestion des erreurs 


La gestion d'erreur est le processus de gestion d'un échec potentiel. Par exemple, ne pas parvenir à lire un fichier et 
continuer à utiliser malgré tout cette mauvaise entrée serait clairement problématique. Cerner et gérer explicitement 
ces erreurs épargne le reste du programme d'un bon nombre de problèmes. 

Pour une explicitation plus exhaustive à propos de la gestion des erreurs, référez-vous à la section dédiée à la gestion 
des erreurs dans le livre officiel. 


16-1 - La macro panic 


Le plus simple mécanisme de gestion d'erreur que nous allons voir est panic. Il affiche un message d'erreur, lance la 
tâche et généralement met fin au programme. Ici, nous appelons explicitement panic dans notre condition : 


I. fn give_princess (gift: &str) { 

2 . 

// Les princesses détestent les serpents, donc nous devons tout arrêter si elles n'acceptent pas ! 
3. if gift == "snake" { panic! ("AAAaaaaa! !!!"); } 

4 . 

5. println!("I love Os!!!!!", gift) ; 

6 . } 

7 . 

8. fn main() { 

9. give__princess ("teddy bear"); 

10. give_j?rincess ( "snake" ) ; 

II . } 


16-2 - L'enum Option et la méthode unwrap 


Dans le dernier exemple, nous avons montré qu'il était possible de mettre en échec le programme quand bon nous 
semble. Nous disions que notre programme pouvait "paniquer" si la princesse recevait un présent inapproprié - un 
serpent. Mais qu'en est-il du cas où la princesse attendait un cadeau mais n'en reçoit pas ? Ce cas de figure serait 
tout bonnement irrecevable, donc inutile d'être géré. 

Nous pourrions tester ce cas contre une chaîne de caractères vide (""), comme nous l'avons fait avec le serpent. 
Puisque nous utilisons Rust, laissons plutôt le compilateur gérer les cas où il n'y pas de cadeau. 

Une enum nommée Option<T> dans la bibliothèque standard est utilisée lorsque "l'absence de" est une possibilité. 
Elle-même est représentée par deux variantes : 

• Some(T) : Un élément de type T a été trouvé ; 

• None : Aucun élément n'a été trouvé. 

Ces cas peuvent être explicitement gérés par le biais de match ou implicitement avec unwrap. La gestion implicite 
renverra l'élément contenu en cas de succès, sinon un panic sera lancé. 

Notez que s'il est possible de personnaliser manuellement le message d'erreur de panic, ce n'est pas le cas pour 
unwrap qui nous laissera avec des informations moins intelligibles qu'une gestion explicite. Dans l'exemple suivant, 
la gestion explicite offre un plus grand contrôle sur le résultat tout en permettant l'utilisation de panic, si désiré. 


1. // Le roturier a déjà tout vu et accepte de bon coeur n'importe quel présent. 

2. // Tous les présents sont gérés explicitement en utilisant 'match'. 

3. fn give_commoner(gift: Option<&str>) { 

4. //On définit une action pour chaque cas. 

5. match gift { 

6. Some ( "snake" ) => println! ("Yuck! I'm throwing that snake in a fire."), 

7. Some(inner) => println! ("{}? How nice.", inner), 

8. None => println! ("No gift? Oh well."). 
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9. } 

10 . } 

11. 

12. // Notre précieuse princesse va 'panic' à la vue des serpents. 

13. // Tous les présents sont gérés implicitement en utilisant 'unwrap'. 

14. fn give_princess(gift: Option<&str>) { 

15. // 'unwrap' renvoie un 'panic' lorsqu'il reçoit la variante 'None'. 

16. let inside = gift.unwrap(); 

17. if inside == "snake" { panic !( "AAAaaaaa!!!!") ; } 

18. 

19. println! ( "I love {} s ! ! ! ! !" , inside); 

20 . } 

21. 

22. fn main() { 

23. let food = Some ( "cabbage" ); 

24. let snake = Some ( "snake" ); 

25. let void = None; 

26. 

27. give_commoner(food); 

28. give_commoner(snake); 

29. give_commoner(void); 

30. 

31. let bird = Some ( "robin" ); 

32. let nothing = None; 

33. 

34. give_princess(bird); 

35. give_princess(nothing); 

36. } 


16-2-1 - Les combinateurs: map 


match est une approche valable pour gérer les Options. Cependant, vous pourriez trouver son utilisation fastidieuse, 
principalement avec des opérations qui ne sont valides qu'avec une entrée. Dans ces cas, les combinateurs peuvent 
être utilisés pour gérer le contrôle du flux de manière plus modulaire. 


Option possède une méthode préfaite appelée map(), un combinateur pour la simple mise en corrélation de Some - 
> Some et None -> None. Les appels de la méthode map() peuvent être chaînés ensemble pour plus de flexibilité. 


Dans l'exemple suivant, processQ remplace toutes les fonctions précédentes tout en restant compacte. 


î. 
2 . 
3. 
4 . 

5. 

6 . 
7 . 


# ! [allow(dead_code)] 

# [dérivé(Debug)] enum Food { Apple, Carrot, Potato } 


#[dérivé(Debug)] 
#[dérivé(Debug)] 
#[dérivé(Debug)] 


struct Peeled(Food); 
struct Chopped(Food); 
struct Cooked(Food); 


9. 

10. // Épluchage de la nourriture. S'il n'y en a pas, alors on renvoie 'None'. 

11. // Sinon, on renvoie la nourriture épluchée. 

12. fn peel(food: Option<Food>) -> Option<Peeled> ( 

13. match food ( 

14. Some (food) => Some (Peeled(food)), 

15. None => None, 

16. } 

17. } 

18. 

19. // Éminçage de la nourriture. S'il n'y en a pas, alors on renvoie 'None'. 

20. // Sinon, on renvoie la nourriture émincée. 

21. fn chop(peeled: Option<Peeled>) -> Option<Chopped> ( 

22. match peeled ( 

23. Some (Peeled(food)) => Some (Chopped(food)), 

24. None => None, 

25. } 

26. } 

27 . 

28. // Cuisson de la nourriture. Ici, nous utilisons 'mapO ' au lieu de 'match' pour la gestion des 


cas. 
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29. fn cook(chopped: Option<Chopped>) -> Option<Cooked> { 

30. chopped.map(|Chopped(food)| Cooked(food)) 

31. } 

32. 

33. // Une fonction pour éplucher, émincer et cuire la nourriture dans une seule séquence. 

34. // Nous chaînons plusieurs appels de ~map()' pour simplifier le code. 

35. fn process(food: Option<Food>) -> Option<Cooked> { 

36. food.map(|f| Peeled(f)) 

37. .map(|Peeled(f)| Chopped(f)) 

38. .map(|Chopped(f)| Cooked(f)) 

39. } 

40. 

41. // On vérifie s'il y a de la nourritre ou pas avant d'essayer de la manger ! 

42. fn eat(food: Option<Cooked>) { 

43. match food { 

44. Some(food) => println! ( "Mmm. I love {:?}", food), 

45. None => println! ("Oh no! It wasn't edible."), 

46. } 

47. } 

48. 

49. fn main() { 

50. let apple = Some (Food::Apple); 

51. let carrot = Some (Food::Carrot); 

52. let potato = None; 

53. 

54. let cooked_apple = cook(chop(peel(apple))); 

55. let cooked_carrot = cook(chop(peel(carrot))); 

56. // Vous remarquerez que 'process()' est bien plus lisible. 

57. let cooked_potato = process(potato); 

58. 

59. eat(cooked_apple); 

60. eat(cooked_carrot); 

61. eat(cooked_potato); 

62. } 


16-2-2 - Les combinateurs: and then 


map() a été décrite comme étant un moyen de chaîner les directives pour simplifier les déclarations match. 
Cependant, utiliser map() sur une fonction qui renvoie déjà une instance de Option<T> risque d'imbriquer le résultat 
dans une autre instance Option<Option<T». Chaîner des appels peut alors prêter à confusion. C'est là où un autre 
combinateur nommé and_then(), connu dans d'autres langages sous le nom de flatmap, entre en jeu. 

and_then() appelle la fonction passée en entrée avec la valeur imbriquée et renvoie le résultat. Si le conteneur Option 
vaut None, alors elle renvoie None à la place. 


Dans l'exemple suivant, cookable_v2() renvoie une instance de Option<Food>. Utiliser la méthode map() au lieu de 
and_then() donnerait une instance imbriquée Option<Option<Food», qui est un type invalide pour la fonction eat(). 


1. # ! [allow(dead_code)] 

2 . 

3. #[dérivé(Debug)] enum Food { CordonBleu, Steak, Sushi } 

4. #[dérivé(Debug)] enum Day ( Monday, Tuesday, Wednesday } 

5. 

6. // Nous n'avons pas les ingrédients pour faire des sushis. 

7. fn have_ingredients(food: Food) -> 0ption<Food> ( 

8. match food ( 


9. Food::Sushi => None, 

10. _ => Some (food), 

11 . } 

12 . } 

13. 

14. // Nous avons la recette de tous les mets sauf celle du Cordon Bleu. 

15. fn have_recipe(food: Food) -> Option<Food> ( 

16. match food ( 

17. Food::CordonBleu => None, 

18. _ => Some (food), 

19. } 
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20. 

} 

21. 


22 . 


23. 

// 

24 . 

// 

25. 

fn 

26. 


27 . 


28. 


29. 


30. 


31. 


32. 


33. 

} 

34. 


35. 

// 

36. 

fn 

37. 


38. 

} 

39. 


40. 

fn 

41. 


42 . 


43. 


44 . 


45. 

} 

46. 


47 . 

fn 

48. 


49. 


50. 


51. 


52. 


53. 

} 


Pour faire un plat, nous avons besoin de deux ingrédients et d'une recette. 
Nous pouvons représenter la logique avec une chaîne de 'match's: 
cookable_vl(food: Food) -> Option<Food> { 
match have_ingredients(food) { 

None => None, 

Some(food) => match have_recipe(food) { 

None => None, 

Some(food) => Some(food), 

}, 

} 


On peut rendre plus compacte cette implémentation en utilisant 'and_then()': 
cookable_v2(food: Food) -> Option<Food> { 
have_ingredients(food),and_then(have_recipe) 


eat(food: Food, day: Day) { 
match cookable_v2(food) { 

Some(food) => println! ("Yay! On {:?} we get to eat day, food), 

None => println! ("Oh no. We don 't get to eat on {:?}?", day), 

} 


maint) { 

let (cordon_bleu, steak, sushi) = (Food::CordonBleu, Food::Steak, Food::Sushi); 

eat(cordon_bleu, Day::Monday); 
eat(steak, Day::Tuesday); 
eat(sushi, Day::Wednesday); 


Voir aussi 

Les closures, Option et Option::and_then(). 


16-3 - L'enum Resuit 


Resuit est une version plus élaborée de l'enum Option qui conçoit une potentielle erreur plutôt qu'une potentielle 
absence. 


Autrement dit, Résulte T, E> pourrait adopter l'un de ces deux états : 

• Ok<T> : Un élément T a été trouvé ; 

• Err<E> : Une erreur a été trouvée avec l'élément E. 

Par convention, la valeur de retour attendue est Ok jusqu'à la preuve du contraire (i.e. qu'une erreur (Err) est 
survenue). 

Tout comme Option, Resuit possède de nombreuses méthodes associées à elle. unwrap(), par exemple, fournit 
l'élément T sinon déclenche panic. Pour la gestion des cas, Resuit possède nombre de combinateurs en commun 
avec Option. 

En travaillant avec Rust, vous rencontrerez probablement des méthodes renvoyant le type Resuit, telles que la 
méthode parse(). Il n'est pas toujours possible de convertir une chaîne de caractères dans un autre type, donc parse() 
renvoie une instance de Resuit indiquant les potentielles erreurs. 

Voyons ce qu'il se passe lorsque nous parvenons à convertir une chaîne de caractères et lorsque ce n'est pas le cas : 
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1. fn double_number(number_str: &str) -> i32 { 

2 . // Essayons d'utiliser la méthode ' unwrap ' pour récupérer le nombre. 

3. // Va-t-elle nous mordre ? 

4. 2 * number_str.parse::<i32>().unwrap() 

5. } 

6 . 

7. fn main() { 

8. let twenty = double_number ("10") ; 

9. println ! ("double is {}", twenty); 

10 . 

11. let tt = double_number( "t" ); 

12. println !( "double is {}", tt) ; 

13. } 

Dans le cas où nous ne parvenons pas à la convertir, parse() nous laisse avec l'erreur sur laquelle unwrap a paniqué. 
Vous noterez également que le message d'erreur affiché par panic est assez désagréable. 

Pour améliorer la qualité de notre message d'erreur, nous devrions être plus rigoureux quant à la valeur de retour 
et envisager de gérer explicitement l'erreur. 


16-3-1 - La méthode map pour Resuit 


Nous avons noté dans l'exemple précédent que le message d'erreur affiché lorsque le programme "panique" ne nous 
était pas d'une grande aide. Pour éviter cela, nous devons être plus précis concernant le type de renvoi. Ici, l'élément 
est de type i32. Pour déterminer le type de Err, jetons un oeil à la documentation de la méthode parse(), qui est 
implémentée avec le trait FromStr pour le type i32. Dans un résultat, le type de Err est ParselntError. 

Dans l'exemple ci-dessous, utiliser directement match mène à coder quelque chose de relativement lourd. 
Heureusement, la méthode map de Option est l'un de ces nombreux combinateurs ont également été implémentés 
pour Resuit. enum.Resuit en tient une liste complète. 


I. use std::num::ParselntError ; 

2 . 

3. // Maintenant que le type de renvoi a été réécrit, nous utilisons le pattern matching 

4. // sans la méthode 'unwrap()'. 

5. fn double_number(number_str: Sstr) -> Result<i32, ParseIntError> { 

6. match number_str.parse::<i32>() { 

7. Ok(n) => 0k(2 * n) , 

8. Err (e) => Err(e), 

9. } 

10. } 

II. 

12 . 

13. // Tout comme avec 'Option', nous pouvons utiliser les combinateurs tels que 'map()'. 

14. // Cette fonction possède le même fonctionnement que celle ci-dessus et se lit comme suit; 

15. // Modifie n si la valeur est valide, sinon renvoie une erreur. 

16. fn double_number_map(number_str: Sstr) -> Result<i32, ParseIntError> { 

17. number_str.parse::<i32>().map(|n| 2 * n) 

18. } 

19. 

20. fn print(resuit : Result<i32, ParseIntError>) { 

21. match resuit { 

22. Ok (n) => println! ( "n is { } " , n) , 

23. Err (e) => println! ("Error: {}", e), 

24. } 

25. } 

26. 

27. fn main() { 

28. // Ceci fournit toujours une réponse valable. 

29. let twenty = double_number( "10" ); 

30. print(twenty); 

31. 

32. // Ce qui suit fournit désormais un message d'erreur plus intelligible. 

33. let tt = double_number_map( "t" ); 

34 . print(tt); 

35. } 
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16-3-2 - Les alias de Resuit 


Quid lorsque nous souhaitons réutiliser un type de Resuit bien précis ? Rappelez-vous que Rust nous permet de 
créer des alias. Nous pouvons alors aisément en définir un pour le type de Resuit en question. 

À l'échelle d'un module, la création d'alias peut être salvatrice. Les erreurs pouvant être trouvées dans un module 
pécis ont souvent le même type (wrappé par Err), donc un seul alias peut définir l'intégralité des Results associés. 
C'est tellement utile que la bibliothèque standard en fournit un: io::Result ! 

Voici un petit exemple pour présenter la syntaxe : 


I. use std::num::ParselntError; 

2 . 

3. // On définit un alias générique pour un type de 'Resuit' avec le type d’erreur 

4. // 'ParselntError'. 

5. type AliasedResult<T> = Result<T, ParseIntError>; 

6. 

7. // On utilise l’alias ci-dessus pour faire référence à notre 

8. // 'Resuit'. 

9. fn double_number(number_str: Sstr) -> AliasedResult<i32> { 

10. number_str.parse: :<i32>() .map(|n| 2 * n) 

II. } 

12 . 

13. // Ici, l’alias nous permet encore d’épargner de l’espace. 

14. fn print(resuit : AliasedResult<i32>) { 

15. match resuit { 

16. Ok(n) => println!("n is {}", n), 

17 . Err(e) => println! ( "Error : {}", e), 

18. } 

19. 1 

20. 

21. fn main() { 

22. print(double_number( "10" )); 

23. print(double_number( "t" )); 

24. } 


Voir aussi 

Resuit et io::Result. 


16-4 - Multiples types d’erreur 


Les exemples précédents ont toujours été très basiques; Les (instances de) Resuit interagissent avec d'autres 
(instances de) Resuit et les Options interagissent avec d'autres Options. 

Parfois une instance d'Option a besoin d'interagir avec un Resuit ou encore un Result<T, Error1> devant interagir 
avec un Result<T, Error2>. Dans ces cas, nous souhaitons gérer nos différents types de manière à pouvoir interagir 
simplement avec eux. 

Dans le code suivant, deux instances de la méthode unwrap() génèrent deux types d'erreur différents. Vec::first 
renvoie une instance de Option, alors que parse::<i32> renvoie une instance de Result<i32, ParselntError> : 


1. fn double_first(vec: Vec<&str>) -> i32 { 

2. let first = vec.first().unwrap(); // Génère la première erreur. 

3. 2 * first.parse::<i32>().unwrap() // Génère la seconde erreur. 

4. } 

5. 

6 . fn main ( ) { 

7. let empty = vec! []; 

8. let strings = vec! ["tofu", "93", "18"]; 

9. 
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10. println! ( "The first doubled is {}", double_first(empty)); 

11. // Erreur 1: Le vecteur passé en entrée est vide. 

12 . 

13. println !( "The first doubled is {}", double_first(strings)); 

14 . // Erreur 2: L'élément ne peut pas être converti en nombre. 

15. } 

En utilisant notre connaissance des combinateurs, nous pouvons réécrire ce qu'il y a au-dessus pour gérer 
explicitement les erreurs. Puisque deux types différents peuvent être rencontrés, nous nous devons de les convertir 
en un type commun tel que String. 

Pour ce faire, nous convertissons les instances d'Option et de Resuit en Results puis nous convertissons leurs erreurs 
respectives sous le même type : 


1. // 

Nous utiliserons 'String' en tant que type d'erreur. 




2. type Result<T> = std::resuit::Result<T, String>; 

•q 





4 . fn 

double first(vec: Vec<&str>) -> Result<i32> { 





5. 

vec.first() 





6. 

// On convertit 1''Option' en un 'Resuit' s 

'il y a une valeur. 



7 . 

// Autrement, on fournit une instance 'Err' 

contenant 

la 'String 



8. 

.ok or("Please use a vector with at least one element 

. " . to owned()) 


9. 

.and then(|s 1 s.parse::<i32>() 





10. 

// On convertit n'importe quelle erreur, générée 

par 

'parse', 

11. 

// en 'String'. 





12 . 

.map err ( | e | e.to stringO) 





13. 

// 'ResultkT, String>' est 

le nouveau 

type de valeur. 


14 . 

// et nous pouvons doubler 

le nombre 

se trouvant 

dans 

le conteneur. 

15. 

.map(|i1 2 * i)) 





16. } 
17 . 

18. fn 

print(resuit: Result<i32>) { 





19. 

match resuit { 





20. 

Ok(n) => println! ("The first doubled is 

{}", n). 




21. 

Err (e) => println !( "Error: {}", e), 





22 . 

23. } 
24 . 

25. fn 

} 

main() { 





26. 

let empty = vec![] ; 





27 . 

let strings = vec!["tofu", "93", "18"]; 





28. 






29. 

print(double first(empty)); 





30. 

print(double first (strings)); 





31. } 







Dans la prochaine section, nous allons voir une méthode pour la gestion explicite de ces erreurs. 

Voir aussi 

Option::ok_or, Result::map_err. 


16-4-1 - Retour prématuré 


Dans l'exemple précédent, nous gérions explicitement les erreurs en utilisant les combinateurs. Une autre manière 
de répondre à cette analyse est d'utiliser une série de match et des retours prématurés. 

Autrement dit, nous pouvons simplement mettre fin à l'exécution de la fonction et renvoyer l'erreur, s'il y en a une. 
Pour certains, cette manière de faire est plus simple à lire et écrire. Voici une nouvelle version de l'exemple précédent, 
réécrit en utilisant les retours prématurés : 

1. // On utilise 'String' comme type d'erreur. 

2. type Result<T> = std:: resuit::Result<T, String>; 
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3. 

4. fn double_first(vec: Vec<&str>) -> Result<i32> { 

5. // On convertit 1''Option' en un 'Resuit' s'il y a une valeur. 

6. // Autrement, on fournit une instance "Err" contenant la 'String'. 

7. let first = match vec. first () { 

8. Some (first) => first, 

9. None => return Err("Please use a vector with at least one element .". to_owned()) , 

10 . } ; 

11. 

12. // On double le nombre dans le conteneur si 'parse' fonctionne 

13. // correctement. 

14. // Sinon, on convertit n'importe quelle erreur, générée par 'parse', 

15. // en String'. 

16. match first.parse::<i32>() { 

17 . Ok (i) => Ok (2 * i) , 

18. Err(e) => Err (e.to_string()), 

19. } 

20 . } 

21. 

22. fn print(resuit : Result<i32>) { 

23. match resuit { 

24. Ok(n) => println! ("The first doubled is {}", n) , 

25. Err(e) => println! ("Error: {}", e), 

26. } 

27. } 

28. 

29. fn main() { 

30. let empty = vec! []; 

31. let strings = vec!["tofu", "93", "18"]; 

32. 

33. print(double_first(empty)); 

34. print(double_first(strings)); 

35. } 


À ce niveau, nous avons appris à gérer explicitement les erreurs en utilisant les combinateurs et les retours 
prématurés. Bien que, généralement, nous souhaitons éviter un plantage, la gestion explicite de toutes nos erreurs 
peut s'avérer relativement lourde. 


Dans la section suivante, nous introduirons la macro try pour couvrir les cas où nous souhaitons simplement utiliser 
unwrapQ sans faire planter le programme. 


16-4-2 - Introduction à try! 


Parfois nous voulons la simplicité de unwrap() sans la possibilité de faire planter le programme. Jusqu'ici, unwrap() 
nous a dévié de ce que nous voulions vraiment : récupérer la variable. C'est exactement le but de try! que de régler 
ce souci. 


Une fois l'instance Err trouvée, il y a deux actions possibles : 

1 panic! que nous avons choisi d'éviter, si possible, avec try! ; 

2 return parce qu'une Err ne peut être traitée. 

La macro try! est presque (1 ) équivalent à la méthode unwrap() mais effectue un renvoi prématuré au lieu de planter 
lorsqu'un conteneur Err est récupéré. Voyons comment nous pouvons simplifier l'exemple précédent qui utilisait les 
combinateurs : 


1. // On utilise une 'String" comme type d’erreur. 

2. type Result<T> = std:: resuit::ResultkT, String>; 

3. 

4. fn double_first(vec: Vec<&str>) -> Result<i32> { 

5. let first = try! (vec.first().ok_or( 

6. "Please use a vector with at least one element .". to_owned() , 

7 . ) ) ; 

8 . 
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9. let value = try! (first.parse::<i32>() ,map_err(|e| e.to_string ( ))); 

10. 

11. 0k(2 * value) 

12 . } 

13. 

14. fn print(resuit : Result<i32>) { 

15. match resuit { 

16. Ok(n) => println! ("The first doubled is {}", n), 

17. Err(e) => println !( "Error: {}", e), 

18. } 

19. } 

20. 

21. fn main() { 

22. let empty = vec! []; 

23. let strings = vec!["tofu", "93", "18"]; 

24 . 

25. print(double_first(empty)); 

26 . print(double_first(strings)) ; 

27. } 


Notez que, jusqu'ici, nous avons utilisé les Strings pour les erreurs. Cependant, elles sont quelque peu limitées en 
tant que type d'erreur. Dans la prochaine section, nous apprendrons à créer des erreurs plus structurées, plus riches, 
en définissant leur propre type. 


Voir aussi 


Resuit et io::Result. 


16-5 - Définition d'un type d'erreur 


Rust nous permet de définir nos propres types d'erreur. En général, un « bon » type d'erreur : 

• représente différentes erreurs avec le même type ; 

• présente un message d'erreur intelligible pour l'utilisateur ; 

• est facilement comparable aux autres types ; 

• Bien : Err(EmptyVec), 

• Pas bien : Err("Please use a vector with at least one element".to_owned()) ; 

• peut supporter l'ajout d'informations à propos de l'erreur ; 

• Bien : Err(BadChar(c, position)), 

• Pas bien : Err("+ cannot be used here".to_owned()). 

Notez qu'une String (que nous utilisions jusqu'ici) remplit les deux premiers critères, mais pas les deux derniers. 
Cela rend la création d'erreurs, simplement en utilisant String, verbeuse et difficile à maintenir. Il ne devrait pas 
être nécessaire de polluer la logique du code avec le formattage des chaînes de caractères pour avoir un affichage 
intelligible. 


1. use std::num::ParselntError; 

2. use std::fmt; 

3. 

4. type Result<T> = std:: resuit ::Result<T, DoubleError>; 

5. 

6. #[dérivé(Debug)] 

7. //On définit nos propres types d'erreur. Ces derniers peuvent être personnalisés pour 

8. // notre gestion des cas. 

9. // Maintenant nous serons capables d'écrire nos propres erreurs et nous reporter 

10. //à leur implémentation. 

11. enum DoubleError { 

12. // Il n'est pas nécessaire de collecter plus d'informations 

13. // pour détailler cette erreur. 

14. EmptyVec, 
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15. 

// 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 
=> 

30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 

59. 

60. 
61. 
62. 


Nous allons nous reporter à l'implémentation couvrant l'erreur de conversion pour ce type. 
// Soumettre des informations supplémentaires nécéssite l'ajout de données pour le type. 
Parse(ParselntError), 


La génération d'une erreur fait abstraction de la manière dont elle est affichée, 
nul besoin de s'occuper de la mécanique sous-jacente. 


Notez que nous ne stockons aucune information supplémentaire à propos de l'erreur. 

Cela signifie que nous ne pouvons préciser quelle chaîne de caractères n'a pas pu être 
convertie, sans modifier nos types pour apporter cette information, 
impi fmt::Display for DoubleError { 

fn fmt(&self, f: &mut fmt: :Formatter) 
match *self { 

DoubleError::EmptyVec 

write! (f, "please use a vector with at least one element" 

// Ceci est un wrapper, donc référrez-vous à l'implémentation de 'fmt' respective 
//à chaque type. 

DoubleError::Parse(ref e) => e.fmt(f), 


-> fmt:: Resuit { 


') , 


fn doublentirst(vec: Vec<&str>) -> Result<i32> { 
vec.first ( ) 

// On remplace l'erreur par notre nouveau type. 

.ok_or(DoubleError:zEmptyVec) 

.and_then(|s| s.parse::<i32>() 

//On met également à jour le nouveau type 
.map_err(DoubleError: :Parse) 

.map(|iI 2 * i)) 


d'erreur ici. 


fn print(resuit : Result<i32>) { 
match resuit { 

Ok(n) => println! ("The first doubled is 
Err(e) => println !( "Error: {}", e), 

} 

} 

fn main() { 

let numbers = vec! ["93", "18"]; 
let empty = vec![] ; 

let strings = vec!["tofu", "93", "18"]; 

print(double_first(numbers)); 
print(double_first(empty)); 
print(double_first(strings)); 

} 


n) , 


Voir aussi 

Resuit et io::Result. 


16-6 - D'autres cas d'utilisation de try! 


Vous avez remarqué, dans l'exemple précédent, que notre réaction immédiate à l'appel de parse « était » de passer 
l'erreur de la bibliothèque dans notre nouveau type : 


.and_then(|s| s.parse: :<i32>() 
.map_err(DoubleError: :Parse) 


Puisque c'est une opération plutôt commune, il ne serait pas inutile qu'elle soit élidée. Hélas, and_then n'étant pas 
suffisamment flexible pour cela, ce n'est pas possible. Nous pouvons, à la place, utiliser try!. 
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La macro try! a été précédemment présentée comme permettrant la récupération de la ressource (unwrap) ou le 
renvoi prématuré, si une erreur survient (return Err(err)). C'est plus ou moins vrai. En réalité, elle utilise soit unwrap 
soit return Err(From::from(err)). Puisque From::from est un utilitaire permettant la conversion entre différents types, 
cela signifie que si vous utilisez try! où l'erreur peut être convertie au type de retour, elle le sera automatiquement. 

Ici, nous réécrivons l'exemple précédent en utilisant try!. Résultat, la méthode map_err disparaîtra lorsque From::from 
sera implémenté pour notre type d'erreur : 


1. 
2 . 
3. 
4 . 

5. 

6 . 
7 . 
8 . 
9. 
10 
11 
12 

13 

14 

15 

16 

17 

18 
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20 
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22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 


use std::num::ParselntError; 
use std::fmt; 

type Result<T> = std:: resuit ::Result<T, DoubleError>; 

#[dérivé(Debug)] 
enum DoubleError { 

EmptyVec, 

Parse(ParselntError) , 


// On implémente la conversion du type 'ParselntError' au type 'DoubleError'. 

// La conversion sera automatiquement appelée par 'try!' si une instance 'ParselntError' 
// doit être convertie en 'DoubleError'. 
impi From<ParseIntError> for DoubleError { 

fn from(err: ParselntError) -> DoubleError { 

DoubleError: :Parse(err) 

} 

} 

impi fmt: : Display for DoubleError { 

fn fmt(&self, f: &mut fmt: :Formatter) -> fmt: : Resuit { 
match *self { 

DoubleError::EmptyVec => 

write! (f, "please use a vector with at least one element"), 

DoubleError::Parse(ref e) => e.fmt(f). 


} 


} 


// La même structure qu'avant mais, plutôt que de chaîner les instances 'Resuit' 
// et 'Option' tout du long, nous utilisons 'try!' pour récupérer immédiatement 
// la valeur contenue. 

fn double_first(vec: Vec<&str>) -> Result<i32> { 

// Convertit toujours en 'Resuit' tout en renseignant comment convertir 
// un 'None'. 

let first = try! (vec.first().ok_or(DoubleError::EmptyVec)); 
let parsed = try !( first.parse :: <i32>()); 

Ok(2 * parsed) 


fn print(resuit : Result<i32>) { 
match resuit { 

0k(n) => println! ("The first doubled is {}", n) , 

Err (e) => println! ("Error: {}", e), 

} 


fn main() { 

let numbers = vec! ["93", "18"]; 
let empty = vec! []; 

let strings = vec!["tofu", "93", "18"]; 


print(double_first(numbers)); 
print(double_first(empty)); 
print(double_first(strings)); 
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C'est effectivement plus acceptable. Comparé à l'original panic, en remplaçant les appels de unwrap par try! nous 
conservons une utilisation assez familière, à l'exception que try! renvoie les types dans un conteneur Resuit, rendant 
leur déstructuration plus abstraite. 

Notez toutefois que vous ne devriez pas systématiquement gérer les erreurs de cette manière pour remplacer les 
appels de unwrap. Cette méthode de gestion d'erreur a triplé le nombre de lignes de code et ne peut pas être considéré 
comme « simple » (même si la taille du code n'est pas énorme). 

En effet, modifier une bibliothèque de 1000 lignes pour remplacer des appels de unwrap et établir une gestion des 
erreurs plus « propre » pourrait être faisable en une centaine de lignes supplémentaires. En revanche, le recyclage 
nécessaire en aval ne serait pas évident. 

Nombreuses sont les bibliothèques qui pourraient s'en sortir en implémentant seulement Display et ajouter From 
comme base pour la gestion. Cependant, pour des bibliothèques plus importantes, l'implémentation de la gestion 
des erreurs peut répondre à des besoins plus spécifiques. 

Voir aussi 

From::from et try!. 


16-7 - Boxing des erreurs 


En implémentant Display et Form pour notre type d'erreur, nous avons usé de presque tous les outils dédiés à la 
gestion d'erreur de la bibliothèque standard. Nous avons cependant oublié quelque chose : la capacité à simplement 
Box notre type. 

La bibliothèque standard convertit n'importe quel type qui implémente le trait Error et sera pris en charge par le type 
Box<Error>, via From. Pour l'utilisateur d'une bibliothèque, ceci permet aisément une manoeuvre de ce genre : 

fn foo(...) -> ResultCT, Box<Error» { ... } 

Un utilisateur peut utiliser nombre de bibliothèques externes, chacune fournissant leurs propres types d'erreur. Pour 
définir un type de Result<T, E> valide, l'utilisateur a plusieurs options : 

• Définir un nouveau wrapper englobant les types d'erreur de la bibliothèque ; 

• Convertir les types d'erreur en String ou vers un autre type intermédiaire ; 

• Box les types dans Box<Error>. 

Le "boxing" du type d'erreur est un choix plutôt habituel. Le problème est que le type de l'erreur sous-jacente est 
connu à l'exécution et n'est pas déterminé statiquement. Comme mentionné plus haut, tout ce qu'il y a à faire c'est 
d'implémenter le trait Error : 


1. trait Error: Debug + Display { 

2. fn description( &self) -> &str; 

3. fn cause (&self) -> Option<&Error>; 

4. } 


Avec cette implémentation, jetons un oeil à notre exemple récemment présenté. Notez qu'il est tout aussi fonctionnel 
avec le type Box<Error> qu'avec DoubleError : 


1. use std::error; 

2. use std::fmt; 

3. use std::num::ParselntError; 

4. 

5. // On modifie l'alias pour ajouter 'Box<error::Error>'. 

6. type Result<T> = std:: resuit ::Result<T, Box<error::Error»; 

7. 
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#[dérivé(Debug)] 
enum DoubleError { 

EmptyVec, 

Parse(ParselntError) , 

} 

impi From<ParseIntError> for DoubleError { 

fn from(err: ParselntError) -> DoubleError { 

DoubleError: :Parse(err) 

} 

} 

impi fmt: : Display for DoubleError { 

fn fmt(&self, f: &mut fmt: :Formatter) -> fmt:: Resuit { 
match *self { 

DoubleError::EmptyVec => 

write! (f, "please use a vector with at least one element"), 
DoubleError::Parse (ref e) => e.fmt(f). 


} 


} 


impi error::Error for DoubleError { 
fn description( &self) -> &str { 
match *self { 

// Courte description de l'erreur. 

// Vous n'êtes pas obligé de renseigner la même description que 
// pour 'Display'. 

DoubleError::EmptyVec => "empty vectors not allowed", 

// Ceci implémente déjà 'Error', on se reporte à sa propre implémentation. 
DoubleError::Parse(ref e) => e.description(), 


} 


} 


fn cause (&self) -> Option<&error::Error> { 
match *self { 

// Pas de cause (i.e. pas d'autre erreur) 

// sous-jacente au déclenchement de cette erreur, donc on renvoie 'None' 
DoubleError::EmptyVec => None, 

// La cause est l'implémentation sous-jacente du type d'erreur. 

// Il (le type) est implicitement casté en '&error::Error'. 


/ Ca fonctionne parce que le type en question a déjà implémenté le trait 
DoubleError::Parse(ref e) => Some(e), 

} 

} 


fn double_first(vec: Vec<&str>) -> Result<i32> { 

let first = try! (vec.first().ok_or(DoubleError::EmptyVec)) ; 
let parsed = try !(first.parse::<i32>()); 


Error 


0k(2 * parsed) 


fn print(resuit : Result<i32>) { 
match resuit { 

Ok(n) => println! ("The first doubled is {}", n) , 
Err (e) => println! ("Error: {}", e), 

} 

} 


fn main() { 

let numbers = vec! ["93", "18"]; 

let empty = vec! []; 

let strings = vec!["tofu", "93" 

print(double_first(numbers)); 
print(double_first(empty)); 
print(double_first(strings)); 


"18"] ; 
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Voir aussi 

Distribution dynamique et le trait Error. 


17 - Les types de la bibliothèque standard 


La bibliothèque standard fournit de nombreux types complexes qui étendent drastiquement l'utilisation des primitifs. 
Voici certains d'entre-eux : 

• Les chaînes de caractères redimensionnables String : "hello world" ; 

• Les vecteurs redimensionnables : [1, 2, 3] ; 

• Les types optionnels : Option<i32> ; 

• Les types dédiés à la gestion des erreurs : Result<i32, i32> ; 

• Les pointeurs alloués dans le tas : Box<i32>. 

Voir aussi 


Les primitifs et la bibliothèque standard. 


17-1 - Les Box, la pile et le tas 


En Rust, toutes les valeurs sont allouées dans la pile, par défaut. Les valeurs peuvent être boxées (i.e. allouées 
dans le tas) en créant une instance de Box<T>. Une "box" est un pointeur intelligent sur une ressource de type T 
allouée dans le tas. Lorsqu'une box sort du contexte, son destructeur est appelé, l'objet à charge est détruit et la 
mémoire du tas libérée. 

Les valeurs « boxées » peuvent être déréférencées en utilisant l'opérateur * ; Ceci supprime un niveau d'indirection. 


I. use std::mem; 

2 . 

3. #[dérivé(Clone, Copy)] 

4. struct Point { 

5. x: f64, 

6. y: f64, 

7 . } 

8. 

9. # [allow(dead_code)] 

10. struct Rectangle { 

II. pl: Point, 

12. p2: Point, 

13. } 

14 . 

15. fn origin() -> Point { 

16. Point { x: 0.0, y: 0.0 } 

17. } 

18. 

19. fn boxed_origin() -> Box<Point> { 

20 . // Alloue cette instance de 'Point' dans le tas et renvoie un pointeur 

21. // sur cette dernière. 

22. Box::new(Point { x: 0.0, y: 0.0 }) 

23. } 

24 . 

25. fn main() { 

26. // (Ici le typage est superflu) 

27 . // Variables allouées dans la pile. 

28. let point: Point = origin(); 

29. let rectangle: Rectangle = Rectangle { 

30. pl: origin(), 

31. p2: Point { x: 3.0, y: 4.0 } 

32 . } ; 

33. 

34. // Rectangle alloué dans le tas. 
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35. let boxed_rectangle: Box<Rectangle> = Box::new(Rectangle { 

36. pl: origin(), 

37 . p2: origin() 

38. }); 

39. 

40. // Le résultat des fonctions peut être boxé également. 

41. let boxed_point: Box<Point> = Box::new(origin()); 

42 . 

43. // Double indirection 

44. let box__in_a_box : Box<Box<Point» = Box : :new(boxed_origin()); 

45. 

46. println! ("Point occupies {} bytes in the stack", 

47. mem::size_of_val(Spoint)); 

48. println! ("Rectangle occupies {} bytes in the stack", 

49. mem::size_of_val(Srectangle)); 

50. 

51. // La taille du pointeur est égale à la taille de la Box. 

52. println! ("Boxed point occupies {} bytes in the stack", 

53. mem::size_of_val(&boxed_point)); 

54. println! ("Boxed rectangle occupies {} bytes in the stack", 

55. mem::size_of_val(&boxed_rectangle)); 

56. println! ("Boxed box occupies {} bytes in the stack", 

57. mem::size_of_val(&box_in_a_box)); 

58. 

59. // La ressource contenue dans 'boxed_point' est copiée dans 

60. // 'unboxed_point'. 

61. let unboxed_point: Point = *boxed_point; 

62. println! ("Unboxed point occupies {} bytes in the stack", 

63. mem::size_of_val(&unboxed_point)); 

64. } 


17-2 - Les vecteurs 


Les vecteurs sont des tableaux redimensionnables. Tout comme les slices, leur taille n'est pas connue à la compilation 
mais ils peuvent être agrandis ou tronqués au cours de l'exécution. Un vecteur est représenté par trois (3) mots : un 
pointeur sur la ressource, sa taille et sa capacité. La capacité indique la quantité de mémoire réservée au vecteur. 
La taille peut augmenter à volonté, tant qu'elle est inférieure à la capacité. Lorsqu'il est nécessaire de franchir cette 
limite, le vecteur est réalloué avec une capacité plus importante. 


1. fn main ( ) { 

2. // Les éléments des itérateurs peuvent être collectés et 

3. // ajoutés dans un vecteur. 

4. let collected_iterator: Vec<i32> = (0.. 10) . collect (); 

5. println !( "Collected (0..10) into: {:?}", collected_iterator); 

6. 

7. // La macro 'vec!' peut être utilisée pour initialiser un vecteur. 

8. let mut xs = vec![li32, 2, 3]; 

9. println! ("Initial vector: {:?}", xs); 

10. 

11. // On ajoute un nouvel élément à la fin du vecteur. 

12. println! ("Push 4 into the vector"); 

13. xs.push(4); 

14. println !( "Vector: {:?}", xs); 

15. 

16 . // Erreur! Les vecteurs immuables ne peuvent pas être 

17. // agrandis. 

18. // collected_iterator.push(0); 

19 . // FIXME A Commentez/décommentez cette ligne 

20. 

21 . // La méthode 'len' renvoie la taille actuelle du vecteur. 

22. println !( "Vector size: {}", xs.len()); 

23. 

24. // L'indexation peut être faite à l'aide des "[]" (1'indexaction débute à 0). 

25. println !( "Second element: {}", xs[l]); 

26. 

27. // 'pop' supprime le dernier élément du vecteur et le renvoie. 

28. println !( "Pop last element: {:?}", xs.popO); 

29. 

30. // Une indexaction hors des capacités du vecteur 
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31. // mène à un plantage du programme. 

32. println! ("Fourth element: {}", xs[3]); 

33. } 


Les méthodes rattachées à la structure Vec peuvent être trouvées au sein du module std::vec. 


17-3 - Les chaînes de caractères 


Il y a deux types de chaînes de caractères en Rust : String et &str. 

Une instance de String est stockée en tant que vecteur d'octets (Vec<u8>) mais garantit de toujours fournir une 
séquence valide encodée en UTF-8. String est alloué dans le tas, redimensionnable et non-nul. 

&str est une slice (&[u8j) qui pointe toujours sur une séquence UTF-8 valide et peut être utilisée comme une vue sur 
une String. Tout comme &[T] est une vue sur une instance Vec<T>. 


1. fn main() { 

2. // (Le typage est optionnel) 

3. // Une référence d'une chaîne de caractères immuable. 

4. let pangram: S'static str = "the quick brown fox jumps over the lazy dog"; 

5. println! ("Pangram: {}", pangram); 

6 . 

7. //On itère sur les mots dans le sens inverse, aucune nouvelle instance 

8. // n'est créée. 

9. println! ("Words in reverse"); 

10. for word in pangram.split_whitespace().rev() { 

11. println! ("> {}", word); 

12 . } 

13. 

14. // On copie les caractères dans un vecteur, les trie et supprime 

15. // les occurrences multiples. 

16. let mut chars: Vec<char> = pangram.chars().collect(); 

17 . chars.sort(); 

18. chars . dedup () ; 

19. 

20. // On créé une instance de 'String' vide et mutable. 

21. let mut string = String::new(); 

22. for c in chars { 

23. // On ajoute un caractère à la fin de la chaîne. 

24. string.push(c); 

25. // On ajoute une nouvelle chaîne à la fin de la chaîne initiale. 

26. string.push_str (", "); 

27. } 

28. 

29. // La chaîne tronquée est une slice de la chaîne originale, il n'y a 

30. // pas de nouvelle allocation. 

31. let chars_to_trim: S [char] = &[' ', ',']; 

32. let trimmed_str: &str = string.trim_matches(chars_to_trim); 

33. println! ("Used characters: {}", trimmed_str); 

34. 

35. // Chaîne allouée dans le tas. 

36. let alice = String::from( "I like dogs"); 

37. // Nouvelle allocation mémoire et stockage de la chaîne modifiée 

38. //à cet endroit. 

39. let bob: String = alice.replace( "dog" , "cat") ; 

40. 

41. println !( "Alice says: {}", alice); 

42. println !( "Bob says: {}", bob); 

43. } 


Les méthodes rattachées à str/String peuvent être trouvées dans les modules std::str et std::string. 
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17-4 - L'énumération Option 


Il est parfois désirable de rattraper les erreurs provenants de différentes parties du programme plutôt que d'appeler 
panic! ; pour ce faire, l'enum Option prend le relais. 

L'enum Option<T> possède deux variantes : 

1 None, pour signaler une erreur ou l'absence d'une valeur, et 

2 Some(value), un tuple qui enveloppe, contient une valeur de type T. 


1. // Une division entre deux entiers qui ne plante pas. 

2. fn checked_division(dividend: i32, divisor: i32) -> Option<i32> { 

3. if divisor == 0 { 

4. // L'échec est représenté par la variante "None". 

5. None 

6. } else { 

7. //Le résultat est enveloppé dans une instance ' Sortie'. 

8. Some (dividend / divisor) 

9. 1 

10 . } 

11. 

12. // Cette fonction gère une division qui peut ne pas fonctionner. 

13. fn try_division(dividend: i32, divisor: i32) { 

14. // Les valeurs d 1 'Option' peuvent être matchées, tout comme les autres enums. 

15. match checked_division(dividend, divisor) { 

16. None => println! ("{} / {} failed!", dividend, divisor), 

17. Some (quotient) => { 

18. println! ("{} / {} = {}", dividend, divisor, quotient) 

19. 1, 

20 . } 

21 . } 

22 . 

23. fn main() { 

24. try_division(4, 2); 

25. try_division(1, 0); 

26. 

27. // L’assignation de 'None' à une variable nécessite de typer cette dernière. 

28. let none: Option<i32> = None; 

29. let _equivalent_none = None::<i32>; 

30. 

31. let optional_float = Some (Of32); 

32. 

33. // "dé-wrapper" une instance de 'Some' va extraire la valeur contenue. 

34. println !("{:? } unwraps to {:?}", optional_float, optional_float.unwrap()); 

35. 

36. // Tenter d'utiliser 'unwrap' sur la variante 'None' fera planter le programme. 

37. println !("{:? } unwraps to {:?}", none, none.unwrap()); 

38. } 


17-5 - L'énumération Resuit 


Nous avons vu que l'enum Option peut être utilisée en tant que valeur de retour depuis les fonctions pouvant échouer, 
où None peut être renvoyé pour indiquer un échec. Il est parfois important d'expliquer pourquoi une opération a 
échoué. Pour ce faire, nous pouvons utiliser Resuit. 

Result<T, E> possède deux variantes : 

1 Ok(valeur) qui signale que l'opération s'est correctement déroulée et enveloppe la valeur renvoyée par 
l'opération (valeur est de type T); 

2 Err(pourquoi) qui signale que l'opération a échoué et enveloppe le pourquoi, qui (espérons-le) nous renseigne 
sur la cause de l'échec (pourquoi est de type E). 


1. mod checked { 
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2. // Les "erreurs" mathématiques que nous voulons gérer. 

3. #[dérivé(Debug)] 

4. pub enum MathError { 

5. DivisionByZero, 

6. NonPositiveLogarithm, 

7. NegativeSquareRoot, 


9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 


pub type MathResult = Result<f64, MathError>; 

pub fn div(x: f64, y: f64) -> MathResult { 
if y == 0.0 { 

// Cette opération échouerait, nous wrappons l'erreur dans une instance 
// 'Err' à la place. 

Err (MathError::DivisionByZero) 

} else { 

// Cette opération est valide, nous renvoyons le résultat wrappé dans 'Ok'. 
Ok (x / y) 

} 

} 

pub fn sqrtfx: f64) -> MathResult { 
if x < 0.0 { 

Err (MathError::NegativeSquareRoot) 

} else { 

Ok (x. sqrt ( ) ) 

} 

} 

pub fn ln(x: f64) -> MathResult { 
if x <= 0.0 { 

Err (MathError::NonPositiveLogarithm) 

} else { 

Ok (x. In ( ) ) 

} 

} 

} 

// 'op(x, y)' === 'sqrt(ln(x /y))' 

fn op(x: f64, y: f64) -> f64 { 

// Ceci est une pyramide de match à trois niveaux ! 
match checked::div(x, y) { 

Err (why) => panic !("{:?}" , why), 

Ok (ratio) => match checked::ln(ratio) { 

Err (why) => panic !("{:?}" , why), 

Ok(ln) => match checked::sqrt(ln) { 

Err (why) => panic !("{:?}" , why), 

Ok(sqrt) => sqrt, 


} 

fn main() { 

// Cette opération va-t-elle échouer ? 
println !("{}" , op(1.0, 10.0)); 

} 


17-5-1 - La macro try! 


Chaîner les résultats en utilisant match peut être très chaotique ; heureusement, la macro try! peut être utilisée pour 
soigner l'écriture. La macro try étend une expression de match où la branche Err(err) étend un retour prématuré 
(return Err(err)) et la branche Ok(ok) étend une expression ok et fournit la ressource. 


1. mod checked { 

2. #[dérivé(Debug)] 

3. enum MathError { 

4. DivisionByZero, 

5. NegativeLogarithm, 
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6. NegativeSquareRoot, 

7. } 


9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 

59. 

60. 
61. 
62. 
63. 


type MathResult = Result<f64, MathError>; 

fn div(x: f64, y: f64) -> MathResult { 
if y == 0.0 { 

Err (MathError: :DivisionByZero) 

} else { 

Ok (x / y) 



fn sqrt(x: f64) -> MathResult { 
if x < 0.0 { 

Err (MathError::NegativeSquareRoot) 

} else { 

Ok (x. sqrt ( ) ) 

} 

} 

fn ln(x: f64) -> MathResult { 
if x < 0.0 { 

Err (MathError::NegativeLogarithm) 

} else { 

Ok (x. In ( ) ) 

} 

} 

// Fonction intermédiaire. 

fn op_(x: f64, y: f64) -> MathResult { 

// Si la fonction 'div' échoue, alors 'DivisionByZero' sera renvoyée, 
let ratio = try!(div(x, y)); 

// Si 'ln' échoue, alors 'NegativeLogarithm' sera renvoyée, 
let ln = try! (ln(ratio)); 

sqrt (ln) 

} 


pub fn op(x: f64, y: f64) { 

match op_(x, y) { 

Err (why) => panic! (match why { 

MathError::NegativeLogarithm 

=> "logarithm of négative number", 
MathError::DivisionByZero 
=> "division by zéro", 

MathError::NegativeSquareRoot 

=> "square root of négative number", 

}) , 

Ok (value) => println !("{}" , value), 


} 

} 

fn main() { 

checked::op(1.0, 10.0); 

} 


N'hésitez pas à consulter la documentation, de nombreuses méthodes sont disponibles pour créer et gérer les 

Resuit. 


17-6 - La macro panic! 


La macro panic! peut être utilisée pour générer un plantage et dérouler la pile. Pendant le déroulement de la pile, 
l'exécution prendra soin de libérer toutes les ressources possédées par le fil d'exécution en appelant le destructeur 
de chaque objet. 
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Puisque nous interagissons avec nos programmes en n'utilisant qu'un seul fil d'exécution, panic! renverra un message 
d'erreur puis mettra un terme à l'exécution. 


1. // Ré-implémentation de la division d'entiers (/). 

2. fn division(dividend: i32, divisor: i32) -> i32 { 

3. if divisor == 0 { 

4. //La division par zéro fait planter le thread courant. 

5. panic! ("division by zéro"); 

6. } else { 

7. dividend / divisor 

8 . } 

9. 1 

10 . 

11. 

12. fn main() { 

13. // Entier alloué dans le tas. 

14. let _x = Box : : new(0i32); 

15. 

16. // Cette opération va déclencher la procédure d'abandon. 

17. division(3, 0); 

18. 

19. println! ("This point won ' t be reached!"); 

20 . 

21. // _x devrait être détruit à ce niveau. 

22. } 


Vérifions que la macro panic! ne cause aucune fuite mémoire. 

1. $ rustc panic.rs && valgrind ./panic 

2. ==4401== Memcheck, a memory error detector 

3. ==4401== Copyright (C) 2002-2013, and GNU GPL'd, by Julian Seward et al. 

4. ==4401== Using Valgrind-3. 10 . 0 .SVN and LibVEX; rerun with -h for copyright info 

5. ==4401== Command: ./panic 

6. ==4401== 

7. thread '<main>' panicked at 'division by zéro', panic.rs: 5 

8. ==4401== 

9. ==4401== HEAP SUMMARY: 

10. ==4401== in use at exit: 0 bytes in 0 blocks 

11. ==4401== total heap usage: 18 allocs, 18 frees, 1,648 bytes allocated 

12. ==4401== 

13. ==4401== Ail heap blocks were freed -- no leaks are possible 

14. ==4401== 

15. ==4401== For counts of detected and suppressed errors, rerun with: -v 

16. ==4401== ERROR SUMMARY: 0 errors from 0 contexts (suppressed: 0 from 0) 


17-7 - La structure HashMap 


Là où les vecteurs stockent leurs valeurs en utilisant un index entier, les HashMaps stockent leurs valeurs en utilisant 
des clés. Les clés d'une HashMap peuvent être des booléens, des chaînes de caractères ou n'importe quel autre 
type qui implémente les traits Eq et Hash. Nous y reviendrons dans la section suivante. 

Tout comme les vecteurs, les HashMap sont redimensionnables mais peuvent également se tronquer elles-mêmes 
lorsqu'elles atteignent la limite de leur capacité. Vous pouvez créer une HashMap avec une capacité donnée en 
utilisant HashMap::with_capacity(uint), ou utiliser HashMap::new() pour récupérer une instance avec une capacité 
initiale par défaut (recommandé). 


1. use std:: collections::HashMap; 

2 . 

3. fn call(number: &str) -> &str { 

4 . match number { 

5. "798-1364" => "We're sorry, the call cannot be completed as dialed. 

6. Please hang up and try again.", 

7. "645-7689" => "Hello, this is Mr. Awesome's Pizza. My name is Fred. 

8. What can I get for you today?", 

9. _ => "Hi! Who is this again?" 
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10 . } 

11. } 

12 . 

13. fn main() { 

14. let mut contacts = HashMap: :new(); 

15. 

16. contacts.insert ("Daniel" , "798-1364"); 

17. contacts.insert ("Ashley" , "645-7689"); 

18. contacts.insert ("Katie" , "435-8291"); 

19. contacts.insert ("Robert" , "956-1745"); 

20. 

21. // Prend une référence en entrée et renvoie un conteneur 'Option<SV>'. 

22. match contacts.get( &"Daniel" ) { 

23. Some (Snumber) => println! ("Calling Daniel: {}", call(number)), 

24. _ => println! ("Don't hâve Daniel's number."), 

25. } 

26. 

27 . 

28. // La méthode 'HashMap::insert() renvoie 'None' 

29. // si la valeur insérée est nouvelle, sinon 'Some(value)'. 

30. contacts.insert ("Daniel" , "164-6743"); 

31. 

32. match contacts.get( &"Ashley" ) { 

33. Some (Snumber) => println! ("Calling Ashley: {}", call(number)), 

34. _ => println! ("Don't hâve Ashley 's number."), 

35. } 

36. 

37. contacts.remove( & ("Ashley" )); 

38. 

39. // La méthode 'HashMap::iter()' renvoie un itérateur qui fournit 

40. // les paires (S'a key, S'a value) dans un ordre arbitraire. 

41. for (contact, Snumber) in contacts.iter() { 

42. println! ("Calling {}: {}", contact, call(number)); 

43. } 

44. } 


Pour plus d"informations à propos du fonctionnement du hashage et des hash maps (parfois appelées hash tables), 
consultez la page wikipédia dédiée aux Hash Tables. 


17-7-1 - Personnaliser les types de clé 


N'importe quel type implémentant les traits Eq et Hash peuvent être une clé dans une HashMap. Ce qui inclut : 

• Le type bool (Bien que peut utile puisqu'il n'y a que deux clés possibles); 

• Le type int, uint et toutes les variantes de ces derniers ; 

• String et &str (note : vous pouvez avoir une HashMap recevant en entrée des String et appeler la méthode 
.get() avec une &str). 

Notez que f32 et f64 n'implémentent pas Hash, sûrement parce les erreurs de précision rendrait leur utilisation en 
tant que clé d'une hashmap poserait des soucis. 

Toutes les classes représentant une collection implémentent Eq et Hash si le type qu'elles contiennent implémentent 
également ces deux traits. Par exemple, Vec<T> implémentera Hash si T l'implémente. 

Vous pouvez facilement implémenter Eq et Hash pour un nouveau type avec cette seule ligne : #[derive(PartialEq, 
Hash)]. 

Le compilateur fera le reste. Si vous souhaitez avoir plus de contrôle sur les détails, vous pouvez implémenter Eq et/ 
ou Hash vous-même. Ce guide ne couvre pas les implémentations spécifiques de Hash. 

Pour tester l'utilisation d'une struct dans une HashMap, créons un simple système d'identification : 


1. use std:: collections::HashMap; 
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2 . 

3. // 'Eq' nécessite de dériver 'PartialEq' sur le type. 

4. #[dérivé(PartialEq, Eq, Hash)] 

5. struct Account<'a>{ 

6. username: &'a str, 

7. password: & ' a str, 


9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 


struct AccountInfo< ' a>{ 
name: &'a str, 
email: &' a str, 


type Accounts<'a> = HashMap<Account< ' a>, AccountInfo< ' a>>; 

fn try_logon< ' a>(accounts: &Accounts< ' a>, 

username: &'a str, password: &' a str){ 
println! ("Username: {}", username); 
println! ("Password: {}", password); 
println! ("Attempting logon.. ."); 

let logon = Account { 
username: username, 
password: password, 

} ; 


match accounts.get(Slogon) { 

Some (account_info) => { 

println! ("Successful logon!"); 

println! ("Name: {}", account_info.name); 

println! ("Email: {}", account_info.email); 

}, 

_ => println! ("Login failed!"). 


fn main(){ 

let mut accounts: Accounts = HashMap::new() ; 

let account = Account { 

username: " j . everyman" , 
password: "passwordl23" , 

1 ; 

let account_info = Accountlnfo { 
name: "John Everyman", 
email: "j.everyman@email.com". 


accounts.insert(account, account_info); 
try_logon(saccounts, "j.everyman" , "psaswordl23" ); 
try_logon(saccounts, "j.everyman" , "passwordl23" ); 


17-7-2 - La structure HashSet 


Voyez une HashSet comme une HashMap où nous nous soucions uniquement des clés (HashSet<T> est, en réalité, 
simplement un wrapper de HashMap<T, ()>). 

Vous pourriez vous demander "Quel est le but ? Je pourrais simplement stocker mes clés dans un Vec". 

La fonctionnalité unique de HashSet est qu'elle garantit l'inexistance d'éléments dupliqués. C'est le contrat que 
n'importe quel ensemble remplit. HashSet n'est qu'une implémentation (voir aussi : BTreeSet). 
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Si vous ajoutez une valeur déjà présente dans l'instance HashSet, (i.e. la nouvelle valeur est égale à l'existante et 
ont toutes deux le même hash), alors la nouvelle valeur remplacera l'ancienne. 

C'est pratique lorsque vous ne souhaitez jamais plus d'une occurrence de quelque chose ou lorsque vous voulez 
savoir si vous possédez déjà quelque chose. Mais les ensembles peuvent faire bien plus que cela. 

Les ensembles ont quatre (4) opérations inhérentes (chacune renvoie un itérateur) : 

1 union : Récupère tous les éléments dans les deux ensembles ; 

2 différence : Récupère tous les éléments qui sont dans le premier ensemble mais pas dans le second ; 

3 intersection : Récupère uniquement les éléments présents dans les deux ensembles ; 

4 symmetric_difference : Récupère tous éléments qui sont dans le premier ou second ensemble mais pas les 
deux. 


Essayons tout cela dans l'exemple suivant. 


I. use std:: collections::HashSet; 

2 . 

3. fn main() { 

4. let mut a: HashSet<i32> = vec!(li32, 2, 3) . into_iter (). collect () ; 

5. let mut b: HashSet<i32> = vec!(2i32, 3, 4 ). into_iter (). collect () ; 

6. 

7. assert ! (a.insert(4)); 

8. assert ! (a.contains (&4)) ; 

9. 

10. // 'HashSet::insert() renvoie false si 

II. // une valeur était déjà présente. 

12. // assert ! (b.insert(4), "Value 4 is already in set B!"); 

13. // FIXME A Commentez/décommentez cette ligne 

14 . 

15. b.insert(5); 

16. 

17. // Si le type d'un élément de la collection implémente le trait 'Debug', 

18. // alors la collection devra, elle aussi, implémenter 'Debug'. 

19. // Elle affiche généralement ses éléments dans le format '[eleml, elem2, ...]'. 

20. println! ("A: {:?}", a); 

21. println! ("B: {:?}", b); 

22 . 

23. // Affiche [1, 2, 3, 4, 5] dans un ordre arbitraire. 

24. println!( "Union : {:?}", a. union ( Sb) .collect::<Vec<&i32>>()); 

25. 

26. // Ceci devrait afficher [1], 

27. println!( "Différence : {:?}", a.différence(&b) .collect::<Vec<&i32>>()); 

28. 

29. // Affiche [2, 3, 4] dans un ordre arbitraire. 

30. println ! ("Intersection : {:?}", a. intersection (&b) . collect :: <Vec<Si32» ()) ; 

31. 

32. // Affiche [1, 5]. 

33. println! ("Symmetric Différence: {:?}", 

34. a.symmetric_difference(Sb) .collect: :<Vec<Si32>>()); 

35. } 


Les exemples originaux proviennent de la documentation. 


18 - Outils standards 


Bien d'autres types sont fournis par la bibliothèque standard pour supporter des choses telles que : 

• Les fils d'exécution ; 

• Les canaux ; 

• Les opérations sur le système de fichiers. 
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Ces types vont bien au-de-là de ce que les primitifs fournissent. 


Voir aussi 


Les primitifs et la bibliothèque standard. 


18-1 - Les fils d'exécution 


Rust fournit un méchanisme de création de fils d'exécution natifs via la fonction spawn. L'argument de cette fonction 
est une closure transférable. 


1. use std::thread; 

2 . 

3. static NTHREADS: i32 = 10; 

4 . 

5. // Ceci est le thread 'main'. 

6. fn main() { 

7. //On créé un vecteur pour récupérer tous les threads 

8. // enfants qui ont été créés . 


9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 


let mut children = vec! []; 

for i in 0..NTHREADS { 

// On passe à un autre thread. 
children.push(thread::spawn(move || { 

println! ("this is thread number {}", i) 

}) ) ; 

} 

for child in children { 

// On attend que le thread se termine. Renvoie un résultat, 
let _ = child. join () ; 

} 


Ces threads seront programmés par le système d'exploitation. 


18-2 - Les canaux 


Rust fournit les canaux asynchrones pour la communication entre les threads. Les canaux permettent l'envoi d'un 
flux unidirectionnel d'information entre deux extrémités : l'envoyeur (Sender) et le receveur (Receiver). 


1. use std::sync::mpsc::{Sender, Receiver}; 

2. use std::sync::mpsc; 

3. use std::thread; 

4 . 

5. static NTHREADS: i32 = 3; 

6 . 

7. fn main() { 


// 

9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 


Les canaux possèdent deux extrémités: l'envoyeur ('Sender<T>') et le receveur ('Receiver<T>') , 
// où 'T' est le type du message à envoyer. 

// (Le typage est optionnel) 

let (tx, rx) : (Sender<i32>, Receiver<i32>) = mpsc: :channel(); 

for id in 0..NTHREADS { 

// L'envoyeur peut être copié, 
let thread_tx = tx.clone (); 

// Chaque thread va envoyer son identifiant par le biais du canal, 
thread::spawn(move II { 

// Le thread prend l'ownership sur 'thread_tx'. 

// Chaque thread va ajouter un message dans le file d'attente 
// dans le canal. 
thread_tx.send(id).unwrap(); 
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23. 

24. // L'envoi est une opération non-bloquante, le thread continuera à 

25. // s'exécuter après l'envoi de son message. 

26. println! ("thread {} finished", id); 

27. }); 

28. } 

29. 

30. // Ici, on récupère tous les messages. 

31. let mut ids = Vec: :with_capacity(NTHREADS as usize); 

32. for _ in 0 .. NTHREADS { 

33. // La méthode 'recv' choisit une message se trouvant dans le canal et 

34. // gèlera le thread courant s’il n’y a aucun message. 

35. ids.push(rx.recv()); 

36. } 

37. 

38. // Montre l’ordre dans lequel les messages ont été envoyés. 

39. println !("{:?}" , ids) ; 

40. } 


18-3 - La structure Path 


La structure Path représente les chemins de fichiers dans le système de fichiers sous-jacent. Il y a deux variantes 
de Path : 

1 posix::Path, pour les systèmes UNIX-like ; 

2 windows::Path, pour Windows. 

Le prélude exporte la variante de Path adaptée à la plateforme. 

Une instance de Path peut être créée à partir du type OsStr et fournit de nombreuses méthodes pour obtenir des 
informations à propos du fichier/répertoire sur lequel le chemin pointe. 

Notez que, en interne, un objet Path n'est pas représenté par une chaîne de caractères UTF-8 mais est stocké dans 
un vecteur d'octets (Vec<u8>). En conséquence, la conversion d'un objet Path en &str n'est pas gratuite et peut 
échouer (un objet Option est renvoyé). 


1. use 

std::path::{Path, PathBuf}; 

2. use 

O 

std::ffi; 


. 

4. fn main ( ) { 


5. 

// Création d'un objet 

'Path' à partir d'une '&'static str'. 

6. 

"7 

let path = Path::new(". 

") ; 

8. 

// La méthode 'display' 

renvoie une structure présentable. 

9. 

let display = path.display(); 

10. 



11. 

// La méthode 'join()' 

fusionne un chemin avec toutes les ressources 

12 . 

// possédant une implémentation de la méthode 'as ref()' pour le type 'Path' et 

13. 

// renvoie un nouveau 

chemin avec le séparateur spécifique à l'OS. 

14 . 

let new path = path.join( "a" ).join( "b" ); 

15. 



16. 

// Convertit le chemin 

en une vue sur une string. 

17 . 

match new path.to str( 

> t 

18. 

None => panic! ("new path is not a valid UTF-8 sequence") , 

19. 

Sortie (s) => println 

!("new path is {}", s), 

20. 

} 


21. } 




N'hésitez pas à cosnulter les autres méthodes de Path et la structure Metadata. 

Voir aussi 
OsStr et Metadata. 
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18-4 - La structure File 


La structure File représente un fichier qui a été ouvert (contient un descripteur de fichier), et donne les accès lecture 
et/ou écriture sur le fichier sous-jacent. 

Puisque de nombreuses choses peuvent mal se passer lorsqu'une opération est effectuée, toutes les méthodes de 
File renvoie le type io::Result<T>, lequel étant un alias pour Result<T, io::Error>. 

Ceci couvre les potentielles erreurs de toutes les opérations d'entrée/sortie explicites. Grâce à cela, le programmeur 
peut visualiser toutes les erreurs possibles et est encouragé à les anticiper. 


18-4-1 - La méthode open 


La méthode statique open() peut être utilisé pour ouvrir un fichier en lecture seule. 

Un objet File est responsable d'une ressource, du descripteur de fichier et prend soin de fermer le fichier lorsqu'il 
est libéré. 


1. // Dans le fichier open.rs 

2. use std: :error: :Error; 


3. use 

std: 

:fs : : File; 


4. use 

std: 

:io: : préludé : : * ; 


5. use 

C. 

std: 

:path: :Path; 


7 . fn main ( ) { 


8. 

// Crée un chemin vers le fichier désiré. 


9. 

let 

path = Path::new( "hello.txt" ); 


10. 

let 

display = path.display(); 


il. 




12 . 

// 

Ouvre le chemin en lecture seule, renvoie 

un objet 'io: :Result<File>'. 

13. 

let 

mut file = match File::open(Spath) { 


14 . 


// La méthode 'description' de 'io::Error 

renvoie une chaîne de caractères 

15. 


// qui décrit l'erreur. 


16. 


Err (why) => panic !( "couldn ' t open {}: {}" 

, display. 

17 . 



why.description( ) ) , 

18. 


Ok(file) => file. 


19. 

}; 



20. 




21. 





22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


// Lit le contenu du fichier dans une chaîne de caractères, renvoie un objet 'io::Result<usize>' 

let mut s = String: : new () ; 

match f ile.read_to_string (&mut s) { 

Err (why) => panic! ( "couldn 1 t read {}: {}", display, 

why.description()), 

Ok (_) => print!("{} contains: \n{} " , display, s), 

} 

// 'file' sort du contexte, le flux ouvert sur le fichier "hello.txt" 

//va être fermé. 


Voici le résultat attendu : 

1. $ écho "Hello World!" > hello.txt 

2. $ rustc open.rs && ./open 

3. hello.txt contains: 

4. Hello World! 

Nous vous encourageons à confronter l'exemple précédent à des cas d'échec différents (e.g. hello.txt n'existe pas, 
hello.txt ne peut pas être lu). 
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18-4-2 - La méthode create 


La méthode statique create() ouvre un fichier en écriture seule. Si le fichier existe déjà, le contenu sera écrasé. 
Autrement, un nouveau fichier sera créé. 


1. // Dans le fichier create.rs 

2. static LOREM_IPSUM: 6,'static str = 

3. "Lorem ipsum dolor sit amet, consectetur adipisicing élit, sed do eiusmod 

4. tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, 

5. quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo 

6. consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse 

7. cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non 

8. proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 

9. " ; 

10. 

11. use std::error::Error ; 

12. use std::io::prelude: : * ; 

13. use std:: fs::File; 

14. use std::path::Path; 

15. 

16. fn main() { 

17. let path = Path::new( "out/lorem_ipsum.txt" ); 

18. let display = path.display(); 

19. 

20. // Ouvre un fichier en écriture seule, renvoie un objet 'io: :Result<File>'. 

21. let mut file = match File::create(Spath) { 

22. Err (why) => panic! ("couldn 1 t create {}: {}", 

23. display, 

24. why.description()), 

25. Ok(file) => file, 

26. } ; 

27 . 

28. // Écrit la chaîne de caractères de 'LOREM_IPSUM' dans 'file', renvoie 

29. //un objet 'io: :Result<()>'. 

30. match file.write_all(LOREM_IPSUM.as_bytes()) { 

31. Err (why) => { 

32. panic !( "couldn 1 t write to {}: {}", display, 

33. why.description()) 

34. }, 

35. Ok (_) => println! ("successfully wrote to {}", display), 

36. } 

37. } 


Voici le résultat attendu : 

1. $ mkdir out 

2. $ rustc create.rs && ./create 

3. successfully wrote to out/lorem_ipsum.txt 

4. $ cat out/lorem_ipsum.txt 

5. Lorem ipsum dolor sit amet, consectetur adipisicing élit, sed do eiusmod 

6. tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, 

7. quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo 

8. consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse 

9. cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non 

10. proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 

Comme pour l'exemple précédent, nous vous encourageons à confronter l'exemple à d'autres cas où l'opération 
pourrait échouer. 

Il existe également d'autres outils pouvant ouvrir des fichiers dans des modes différents tels que : read+write, append, 
etc. 
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18-5 - Les sous-processus 


La structure process::Output représente la sortie d'un sous-processus terminé et la structure process::Command est 
un constructeur de processus. 


I. use std::process::Command; 

2 . 

3. fn main() { 

4. let output = Command::new ("rustc") 

5. .arg( "--version" ) 

6. .output().unwrap or else(|e I { 

7. panic! ( "failed to execute process: {}", e) 

8 . } ) ; 

9. 

10. if output.status.success() { 

II. let s = String::from_utf8_lossy(Soutput.stdout); 
12 . 

13. print !( "rustc succeeded and stdout was:\n{}", s); 

14. } else { 

15. let s = String::from_utf8_lossy(Soutput.stderr); 

16. 

17. print !( "rustc failed and stderr was:\n{}", s); 

18. } 

19. 1 


Nous vous encourageons à essayer l'exemple précédent en lançant rustc avec un flag incorrect. 


18-5-1 - Les pipes 


La structure Process représente un processus en cours d'exécution et expose la gestion de stdin, stdout et stderr 
pour interagir avec le processus sous-jacent via les pipes. 


1. use std::error::Error ; 

2. use std::io::prelude: : * ; 

3. use std::process::{Command, Stdio}; 

4 . 

5. static PANGRAM: & ' static str = 

6. "the quick brown fox jumped over the lazy dog\n"; 

7 . 


8. fn main() { 


9. 

10 . 
11 . 
12 . 
13. 
14 . 

15. 

16. 
17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 

33. 
// 


// On crée un processus dans lequel la commande 'wc' va s'exécuter. 

let process = match Command::new ("wc") 

.stdin(Stdio::piped()) 

.stdout(Stdio::piped()) 

.spawn() { 

Err (why) => panic! ("couldn't spawn wc: {}", why.description()), 
Ok (process) => process, 

} ; 


// On écrit quelque chose dans l'entrée standard de 'wc'. 

// 'stdin' est de type 'Option<ChildStdin>', mais puisque nous savons que 
// cette instance en possède une, nous pouvons directement 1’'unwrap()'. 
match process.stdin.unwrap().write_all(PANGRAM.as_bytes()) { 

Err (why) => panic! ("couldn't Write to wc stdin: {}", 
why.description()), 

Ok (_) => println! ("sent pangram to wc"), 

} 

// Puisque 'stdin' ne survit pas après l'appel du dessus, elle va être libérée et 
// et le pipe fermé. 

// 

// C'est très important sinon 'wc' ne pourrait pas commencer à traiter l'entrée 
// que nous avons soumis. 


La champ 'stdout' est également de type 'Option<ChildStdout>' et doit donc être 'unwrap()'. 
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34. let mut s = String :: new () ; 

35. match process.stdout.unwrap().read_to_string( &mut s) { 

36. Err (why) => panic! ("couldn't read wc stdout: {}", 

37. why.description()), 

38. Ok (_) => print! ("wc responded with:\n{}", s), 

39. } 

40. } 


18-5-2 - La méthode wait 


Vous souhaiteriez peut-être attendre qu'un processus, dont un objet process::Child est responsable, se termine. Pour 
cela vous devez appeler la méthode Child::wait qui renverra un objet process::ExitStatus. 


1. 

// 

Dans le fichier wait.rs 




2 . 

3. 

use std::process: :Command; 




4 . 

fn 

main() { 




5. 


let mut child = Command: :new("sleep") 

.arg ("5") 

.spawn() 

i.unwrap(); 

6. 

-] 


let resuit = child.wait().unwrap(); 




8. 


println! ("reached end of main"); 




9. 

} 






i. 

$ rustc wait.rs && ./wait 


2 . 

reached end of main 


3. 

# 'wait' s'est exécuté pendant 5 

secondes. 

4 . 

# Une fois la commande 'sleep 5' 

terminée notre programme 'wait' a pris fin. 


18-6 - Opérations sur le système de fichiers 


Le module std::io::fs contient de nombreuses fonctions traitant avec le système de fichiers. 


1. // Dans le fichier fs.rs 

2. use std:: fs; 

3. use std::fs : :{File, OpenOptions}; 

4. use std::io; 

5. use std::io::prelude: : * ; 

6. use std:: os ::unix; 

7. use std::path::Path; 

8. 

9. // Une simple implémentation de la commande 'cat path'. 

10. fn cat(path: SPath) -> io::Result<String> { 

11. let mut f = try ! (File::open(path)); 

12. let mut s = String::new(); 

13. match f.read_to_string( &mut s) { 

14. Ok (_) => Ok (s) , 

15. Err(e) => Err(e), 

16. } 

17. } 

18. 

19. // Une simple implémentation de la commande 'écho s > path'. 

20. fn echo(s: &str, path: SPath) -> io: : Result< ()> { 

21. let mut f = try ! (File::create(path)); 

22 . 

23. f.write_all(s.as_bytes()) 

24. } 

25. 

26. // Une simple implémentation de la commande 'touch path' (ignore les fichiers existants). 

27. fn touch(path: SPath) -> io: : Result< ()> { 

28. match OpenOptions::new().create (true) .write (true) .open(path) { 

29. 0k (_) => 0k ( ( ) ) , 

30. Err(e) => Err(e), 

31. } 

32. } 

33. 

34. fn main ( ) { 
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35. println! ( "' mkdir a'"); 

36. // Crée un répertoire et renvoie un objet 'io: :Result<()>'. 

37. match fs : :create_dir( "a" ) { 

38 . Err (why) => println! ( "! {:?}", why.kind()), 

39. Ok(_) => {}, 

40. } 

41. 

42. println! ("'écho hello > a/b.txt'"); 

43. // Le match précédent peut être simplifié en utilisant la méthode 'unwrap_or_else()'. 

44. écho( "hello" , SPath::new( "a/b.txt" )).unwrap_or_else(|why| { 

45. println! ( "! {:?}", why.kind()); 

46. }); 

47 . 

48. println !(" 'mkdir -p a/c/d’"); 

49. // Crée un répertoire récursivement, renvoie un objet 'io: :Resultk()>'. 

50. fs : :create_dir_all( "a/c/d" ) .unwrap_or_else(|why| { 

51. println! ( "! {:?}", why.kind()); 

52. } ) ; 

53. 

54. println !("' touch a/c/e . txt '") ; 

55. touch(SPath::new( "a/c/e.txt" )).unwrap_or_else(|why| { 

56. println! ( "! {:?}", why.kind()); 

57. }); 

58. 

59. println !("' In -s ../b. txt a/c/b . txt '") ; 

60. // Crée un lien symbolique, renvoie un objet 'io: :Resultk()>'. 

61. if cfg! (target_family = "unix") { 

62. unix: :fs : :symlink (".. /b .txt" , "a/c/b.txt" ).unwrap or else(|why| { 

63 . println! ( "! {:?}", why.kind()); 

64. }); 

65. } 

66. 

67. println !("' cat a/c/b . txt '") ; 

68. match cat(SPath::new( "a/c/b.txt" )) { 

69. Err (why) => println! ( "! {:?}", why.kind()), 

70. 0k(s) => println! ("> {}", s), 

71. } 

72 . 

73. println !("' ls a'"); 

74. // Lit le contenu d'un répertoire, renvoie un objet 'io: :Result<Vec<Path>>'. 

75. match fs : :read_dir( "a" ) { 

76. Err (why) => println! ( "! {:?}", why.kind()), 

77. Ok(paths) => for path in paths { 

78. println! ("> {:?}", path. unwrap (). path ()) ; 

79. }, 

80. } 

81. 

82. println !("' rm a/c/e . txt '") ; 

83. // Supprime un fichier, renvoie un objet 'io: :Result<()>'. 

84. fs::remove_file ("a/c/e.txt" ).unwrap_or_else(|why| { 

85. println!)"! {:?}", why.kindO); 

86. }); 

87. 

88. println !("' rmdir a/c/d'") ; 

89. // Supprime un répertoire vide, renvoie un objet 'io: :Result<()>'. 

90. fs : :remove_dir ("a/c/d" ) ,unwrap_or_else(|why| { 

91. println! ( "! {:?}", why.kind()); 

92 . } ) ; 

93. } 


Voici le résultat attendu : 


1. $ rustc fs.rs SS ./fs 

2. 'mkdir a' 

3. 'écho hello > a/b.txt' 

4. 'mkdir -p a/c/d' 

5. 'touch a/c/e.txt' 

6. in -s ../b. txt a/c/b. txt' 

7. 'cat a/c/b. txt' 

8. > hello 

9. 'Isa' 
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10. > "a/b.txt" 

11. > " a/c " 

12. ' rm a/c/e .txt' 

13. "rmdir a/ c/d' 


Et l'état final du répertoire a est : 

1. $ tree a 

2. a 

3. |-- b.txt 
4 . ' — c 

5. -- b.txt -> ../b.txt 

6 . 

7. 1 directory, 2 files 

Voir aussi 
La macro cfg!. 


18-7 - Les arguments du programme 


Les arguments passés en ligne de commande peuvent être récupérés en utilisant std::env::args qui renvoie un 
itérateur fournissant une String pour chaque argument : 


1 . 

2 . 

3. 

use std::env; 



fn main() { 



4 . 

5 . 

let args: Vec<String> = env: :args() . collect(); 



6. 

// Le premier argument est le chemin à partir duquel 

le 

programme 

7 . 

// a été appelé. 



8. 

g 

println! ("My path is {}.", args[0]); 



10. 

// Le reste des arguments sont ceux passés en ligne 

de 

commande au programme . 

11 , 

// On appelle le programme comme ceci: 



12 . 

// $ ./args argl arg2 



13. 

println! ("I got {:?} arguments: {:?}.", args.len() - 

• 1 , 

&args[1 .. ]); 

14 . 

. } 




$ ./args 123 




My path is ./args. 




I got 3 arguments: 

["1", 

"2", 

"3"] . 


18-7-1 - Récupération des arguments 


Le pattern matching peut être utilisé pour traiter de simples arguments : 


1. use std::env; 

2 . 

3. fn increase(number: i32) { 

4. println! ("{}", number + 1); 

5. } 

6 . 

7. fn decrease(number: i32) { 

8. println !("{}" , number - 1); 

9. } 

10. 

11. fn help() { 

12. println! ("usage: 

13. match_args <string> 

14. Check whether given string is the answer. 

15. match_args {{increase|decrease}} <integer> 

16. Increase or decrease given integer by one ." ); 
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17 . 
18. 

19. 

20 . 
21 . 
22 . 
23. 
24 . 

25. 

26. 
27 . 
28. 

29. 

30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 
42 . 
43. 
44 . 

45. 

46. 
47 . 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 

59. 

60. 
61. 
62. 

63. 

64. 

65. 


} 

fn main() { 

let args: Vec<String> = env: :args() .collect ( ); 

match args.len() { 

// Pas d'arguments passés. 

1 => { 

println! ("My name is ' match_args '. Try passing some arguments 

}, 

// Un seul argument passé. 

2 => { 

match args[1].parse() { 

Ok(42) => println! ("This is the answer! ") , 

_ => println! ("This is not the answer."), 


// Une commande et un argument passé. 

3 => { 

let cmd = &args[l]; 
let num = &args[2]; 

// On traite le nombre. 

let number: i32 = match num.parse() { 

Ok (n) => { 
n 

}, 

Err (_) => { 

println! ("error: second argument not an integer"); 
help(); 

return; 

}, 

} ; 

// On traite la commande, 
match &cmd[..] { 

"increase" => increase(number), 

"decrease" => decrease(number), 

_ => { 

println! ("error: invalid command" ); 
help(); 


// On couvre tous les autres cas... 
_ => < 

// ... en affichant l'aide, 
help(); 

} 

} 

} 


) ; 


1. $ ./match_args Rust 

2. This is not the answer. 

3. $ ./match_args 42 

4. This is the answer! 

5. $ ./match_args do something 

6. error: second argument not an integer 

7. usage: 

8. match_args <string> 

9. Check whether given string is the answer. 

10. match_args {increase|decrease} <integer> 

11. Increase or decrease given integer by one. 

12. $ ,/match_args do 42 

13. error: invalid command 

14. usage: 

15. match_args <string> 

16. Check whether given string is the answer. 

17. match_args {increase|decrease} <integer> 

18. Increase or decrease given integer by one. 

19. $ ./match_args increase 42 

20. 43 
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18-8- FFI 


Rust fournit une Interface pour Fonction Externe (« Foreign Function Interface », dans la langue de Shakespear) pour 
les bibliothèques écrites en C. Les fonctions externes peuvent être déclarées dans un bloc extern annoté de l'attribut 
#[link] contenant le nom de la bibliothèque externe. 


1. 

// Dans le fichier ffi.rs 


2 . 

O 

use std::fmt; 


O . 

4 . 

// Ce bloc externe lie la bibliothèque libm. 


5. 

#[link(name = "m" )] 


6. 

extern { 


7 . 

// Ceci est une fonction externe 


8. 

// qui calcule la racine carrée d'un nombre complexe à ; 

précision simple. 

9. 

fn csqrtf(z: Complex) -> Complex; 


10. 

. } 


11. 



12 . 

. fn main() { 


13. 

-H 

O 

+ 

1 

II 

N 


14 . 

let z = Complex { re: -1., im: 0. }; 


15. 



16. 

// Appeler une fonction externe est une opération dite 

"à risque". 

17 . 

let z sqrt = unsafe { 


18. 

csqrtf(z) 


19. 

} ; 


20. 



21. 

println! ("the square root of {:?} is {:?}", z, z sqrt) 

; 

22 . 

. } 


23. 



24 . 

. // Implémentation minimale d'un nombre complex à précision 

simple. 

25. 

. #[repr(C)] 


26. 

. #[dérivé(Clone, Copy)] 


27 . 

. struct Complex { 


28. 

re: f32. 


29. 

im: f32, 


30. 

. 1 


31. 



32. 

. impi fmt::Debug for Complex { 


33. 

fn fmt(&self, f: Smut fmt: :Formatter) -> fmt::Result { 


34. 

if self.im < 0. { 


35. 

write! (f, "{}-{}i", self.re, -self.im) 


36. 

} else { 


37. 

Write! (f, "{}+{}!", self.re, self.im) 


38. 

1 


39. 

} 


40. 

. 1 



$ rustc ffi.rs && ./ffi 

the square root of -1+Oi is O+li 


Puisque l'appel de fonctions externes est considéré comme « à risque », il est courant d'écrire des wrappers sécurisés. 

1. // Dans le fichier safe.rs 

2. use std::fmt; 

3. 

4. #[link(name = "m")] 

5. extern { 

6. fn ccosf(z: Complex) -> Complex; 

7. } 

8 . 

9. // Wrapper sécurisé. 

10. fn cos (z: Complex) -> Complex { 

11. unsafe { ccosf(z) } 

12. } 

13. 

14. fn main() { 

15. // z = 0 + 11 

16. let z = Complex { re: 0., im: 1. }; 
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17. 

18. println ! ( "cos({ : ?} ) = {:?}", z, cos(z)); 

19. } 

20 . 

21. // Implémentation minimale d'un nombre complexe à précision simple. 

22. #[repr (C)] 

23. #[dérivé(Clone, Copy)] 

24. struct Complex { 

25. re: f32, 

26. im: f32, 

27. } 

28. 

29. impi fmt::Debug for Complex { 

30. fn fmt(&self, f: &mut fmt: :Formatter) -> fmt:: Resuit { 

31. if self.im < 0. { 

32. write! (f, "{}-{}i", self.re, -self.im) 

33. } else { 

34. write! (f, "{}+{}i", self.re, self.im) 

35. } 

36. } 

37. } 


19 - Divers 


Certaines sections ne sont pas tout à fait liées à la manière dont vous programmez mais vous introduisent et 
fournissent des outils facilitant les choses pour tout le monde. Ces sections abordent : 

• La documentation : Générez la documentation d'une bibliothèque pour les utilisateurs via rustdoc ; 

• Les tests : Créez des suites de tests pour garantir l'intégrité de vos bibliothèques ; 

• Les benchmarks : Créez des benchmarks de vos fonctionnalités pour garantir leur performance. 


19-1 - Documentation 


Les commentaires de documentation sont très utiles pour d'importants projets nécessitant une documentation. 
Lorsque vous lancez Rustdoc, ce sont ces commentaires qui seront compilés dans la documentation. Ils sont préfixés 
par la séquence III et supportent Markdown. 

I. // # ! [crate_name = "doc"] 

2 . 

3. /// Un être humain est représenté ici. 

4. pub struct Person { 

5. /// Une personne doit avoir un nom. 

6. name: String, 

7. } 

8. 

9. impi Person { 

10 . 

II. 

12 . 

13. 

14 . 

15. 

16. 

17 . 

18. 

19. 

20. 

21. 

22 . 

23. 

24 . 

25. 

26. 

27 . 

28. 

29. 
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/// Renvoie une personne avec le nom qu'on lui a donné. 

III 

III # Arguments 
III 

III * 'name' - Une slice qui contient le nom de la personne. 

III 

III # Example 
/// 

III 

III II Vous pouvez écrire du code rust entre les balises 
III II dans les commentaires. 

III II Si vous passez --test à Rustdoc, il testera même la source pour vous 
III use doc::Person; 

III let person = Person::new( "name" ); 

III 

pub fn new(name: &str) -> Person { 

Person { name: name.to_string() } 

} 

III Affiche un salut amical ! 
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30. III 

31. III Affiche "Hello, [name]" à l'objet 'Person' en question. 

32. pub fn hello (Sself) { 

33. println !( "Hello, {}!", self. name); 

34. } 

35. } 

36. 

37. fn main ( ) { 

38. let john = Person::new( "John" ); 

39. 

40. john.hello(); 

41. } 


Note : si vous souhaitez compiler ce programme vous-même, n'oubliez pas de décommenter 
la ligne // #![crate_name = "doc"]. 


Pour lancer les tests, vous devez tout d'abord compiler le code en mode bibliothèque puis renseigner la position de 
la bibliothèque à rustdoc pour qu'il puisse la lier à chaque programme de la documentation : 

rustc doc.rs --crate-type lib 
rustdoc --test --extern doc="libdoc .rs" 


Lorsque vous exécutez la commande cargo test sur une crate, Cargo générera et exécutera automatiquement les 
commandes respectives de rustc et rustdoc. 


19-2 - Tests 


Les fonctions peuvent être testées en utilisant ces attributs: 


#[test] désigne une fonction comme test unitaire. La fonction ne doit prendre aucun paramètre et ne rien 
renvoyer ; 

#[should_panic] désigne une fonction comme un test voué à l'échec. 


T. il 

Dans le fichier unit test.rs 


2. Il 

Compile 'main' à condition que la compilation des tests ne soit pas activée. 

3. # [cfg(not(test) )] 


4. fn 

main() { 


5. 

println! ("If you see this, the tests 

were not compiled nor ran!"); 

6. } 

7 . 



8. U 

Compile le module 'test' seulement si 

la compilation des tests est activée. 

9 . # [cfg(test) ] 


10. mod test { 


11. Il 

Un test unitaire ' distance_test ' est 

nécessaire. 

12 . 

fn distance(a: (f32, f32), b: (f32. 

f32)) -> f32 { 

13. 

( 


14 . 

(b.O - a.0).powi(2) + 


15. 

(b.1 - a.1).powi(2) 


16. 

) . sqrt () 


17 . 

} 


18. 



19. 

# [test] 


20. 

fn distance test() ( 


21. 

assert ! (distance ( (Of32, 0f32), 

( lf32, lf32 )) == (2f32) .sqrt ()); 

22 . 

} 


23. 



24 . 

# [test] 


25. 

# [should panic] 


26. 

fn failing test() { 


27 . 

assert! (H32 == 2i32); 


28. 

} 


29. } 
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Les tests peuvent être exécutés avec la commande cargo test ou rustc --test. 


1. 

$ rustc --test unit test.rs 


2 . 

$ ./unit test 


3. 



4 . 

running 2 tests 


5. 

test testdistance test .. 

. ok 

6. 

n 

test test : :failing test ... 

ok 

/ . 

8. 

test resuit: ok. 2 passed; 

0 failed; 0 ignored; 0 measured 


Si --test n'a pas été inclut alors il devrait se passer ceci : 

$ rustc unit_test.rs 
$ ./unit_test 

If you see this, the tests were not compiled nor ran! 


Voir aussi 

Les attributs, la compilation conditionnelle et mod. 


20 - Opérations à risque 


Pour reprendre ce que la documentation officielle dit : « Il faudrait essayer de minimiser la quantité de code à risque 
dans la base du code. » Avec ceci en tête, commençons ! Les blocs unsafe en Rust sont utilisés pour contourner les 
protections mises en place par le compilateur ; plus précisément, il y a quatre principaux cas d'utilisation que nous 
pouvons retrouver dans les blocs unsafe : 

1 Le déréférencement des pointeurs bruts ; 

2 L'appel d'une fonction à partir de la FFI (cette partie est couverte à d'autres endroits dans le livre) ; 

3 La modification des types par le biais de std::mem::transmute ; 

4 Inliner de l'assembleur. 

Les pointeurs bruts 

Les pointeurs bruts * et références &T fonctionnent de la même manière mais les références sont toujours sécurisées 
parce qu'elles garantissent de pointer sur une ressource valide grâce au vérificateur d'emprunts. Le déréférencement 
d'un pointeur brut ne peut se faire que par le biais d'un bloc unsafe. 

1. // Dans le fichier pointer.rs 

2. fn main() { 

3. let raw_p: *const u32 = &10; 

4 . 

5. unsafe { 

6. assert! (*raw_p == 10); 

7. } 

8 . } 

Transmuter 

Permet une simple conversion d'un type à l'autre, cependant les deux types doivent disposer de la même taille en 
mémoire et le même alignement : 


1. // Dans le fichier transmute.rs 

2. fn main() { 

3. let u: & [u8] = & [49, 50, 51]; 

4. 

5. unsafe { 

6. assert! (u == std::mem:: transmute ::<&str, & [u8]> ("123") ); 

7. } 
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*. } 
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1 : Consultez cette section pour plus de détails. 
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